Be FAIR

Learning Objectives

Be able to:

  • Know what is FAIR
  • Use metadata with BioSchemas to be FAIR

Findable, Accessible, Interoperable, and Reusable

FAIR guidelines were designed for scientific data and stewardship but are easily appliable to educational resources.

For your workshop materials to be the most useful, learners need to be able to find them (google, links from other sources), they need to be available to anyone, they need to work on Windows, Mac, and Linux, and the contents need to be adaptable or modifiable.

Having your content on GitHub is a good start for accessibility and adding CC-ShareAlike licenses helps with reusability. Using metadata tags and BioSchemas in your page templates will help with findability.

Metadata Tags and BioSchemas

Metadata tags are tags that keep the content from being displayed on your site but are machine readable.

In BioSchemas, somethings that you want to include but don’t necessarily want displayed are:

  • the event type
  • the audience group
  • the learning resource type
  • the license
  • the content author
  • what workshop this is part of
  • the date the content was last modified
  • a description of the content

Several groups, including GOBLET’s Standards Committee, are working on best practices for using BioSchemas to tag educational content from in-person and online workshops.

Here is the code snippet that we will add to the <head> section of our workshop landing and tutorial templates that we created in rule 3. Paste this code right before the </head> tag in the 2 layouts. Remember to include this code in any new layouts you create!

Let’s pull all our changes to our local computer. On your local computer in your website repo type:

git pull origin master

Next rule