Revise How to add markup tutorial

[AlasdairGray]

At the community call on 28 June 2021 the following issues were identified with a brief scan of the How to add markup tutorial:

• It's not long enough (@nsjuty / @AlasdairGray )
• Missing statement on where the content needs to be added, and what creates that HTML (@egonw )
• Where to put the JSON-LD in the HTML page? Multiple places in cases of multiple objects (@egonw )

Originally posted by @AlasdairGray in https://github.com/BioSchemas/specifications/issues/488#issuecomment-870733495

[AlasdairGray]

• [ ] @AlasdairGray to add content from markupathon slides
• [ ] @ivanmicetic to add experience from IDP use case
• [ ] @alaninmcr to add experience from ComputationalWorkflow perspective
• [ ] @albangaignard to add experience from ComputationalTool perspective

The different perspectives may be extracted out into dedicated recipes for those communities.

[AlasdairGray]

There is probably cross-over with the content of the How to select the right profile for your resource

[ljgarcia]

I think the different perspectives are more for How to select the right profile for your resource than for How to add markup.

Related issues:

• ComputationalTool https://github.com/BioSchemas/specifications/issues/547
• Chemical profiles https://github.com/BioSchemas/specifications/issues/554

[ljgarcia]

The How to add markup tutorial has been updated and is ready for review, see https://github.com/BioSchemas/bioschemas.github.io/pull/447

[AlasdairGray]

I think the different perspectives are more for How to select the right profile for your resource than for How to add markup.

Related issues:

• ComputationalTool Add paragraph about ComputationTool to Choosing the Right Profile tutorial #547
• Chemical profiles Add paragraph about chemical profiles to Choosing the Right Profile tutorial #554

I agree, can we move these into a separate issue for that tutorial. Once that is done this issue can be closed.