Getting Started with Bioschemas

A quick tour on what this training portal offers

Bioschemas aims to improve findability and interoperability for Life Science resources. It does so by guiding the use of Schema.org markup on Life Science websites. Guidelines include recommendations on the properties to be used together with the cardinality, ONE or MANY. It also offers recommendation on some well-known ontology terms for some particular properties. All those recommendations are what we call a “Bioschemas Profile”. Bioschemas also leads the development and posterior inclusion in Schema.org of some common types used in Life Sciences, i.e., Bioschemas types.

If what we just said is not so clear to you yet, do not worry about it; this training portal is here to help you understand how to use Bioschemas Types and Profiles. Find below the right place to start with.

We have identified four audience groups who might be interested in Bioschemas tutorials. On each tutorial, as part of the “audience” description, we will always include which group we think a tutorial mostly applies to. The four audience groups are:

• General interest: people who want to get introduced to Bioschemas
• Markup provider: (aka content creator/web developer) people interested in adding Bioschemas markup to their web pages
• Markup consumer: people who are interested in consuming the markup offered by the providers group
• Specification developers: people who want to contribute to the creation and development of specifications (either types or profiles)

Brief introduction to Schema.org and Bioschemas

All tutorials in this section target the “General interest” audience group. If you fall in any of the other groups but are fairly new to the topic, we invite you to start your journey here.

• If you are new to Schema.org and Bioschemas, please start with What and why Schema.org
• If you already know about Schema.org and want to get a better understanding on structured data benefits, please have a look at our pratical example on Schema.org markup. “Markup providers” and “Markup consumers” will find initial information on how such markup looks like on the page and behind the scenes
• If you already know about Schema.org and want to learn more Bioschemas, please go to What and why Bioschemas

Markup How-to guidelines

The main target audience for these how-to guides are “Markup providers”. The secondary target audience are “Markup consumers”.

• If you already know about Schema.org and Bioschemas, and you are ready to add markup to your resource, then see our Starting by the selection of the right profile for your case guide.
• If you want to add Bioschemas structured data to your pages, use our guide to add markup to your own resource
• If you want to add markup to a GitHub pages site, see our guide for marking up on GitHub pages
• To check that your markup is deployed and can be retrieved by others, see our guide on checking your deployed markup

Specification Development How-to Guides

The target audience for these how-to guides are “Specification developers”.

• If you want to create a new profile, our How to includes all the information you need to do so.
• If you need to create a new version of an existing profile then see guide to updating a profile

Community-tailored tutorials

Life science communities, in particular ELIXIR communities, offer some tutorials tailored to their own needs. More information can be found on the community-based tutorials page.

Feedback

For feedback, questions and comments, please create an issue and label it topic:Training Portal.