How we support FAIR

Author: PhilReedData

TeSS_docs/_toc.yml

@@ -11,6 +11,7 @@ parts:
     - file: overview/mtess-x
     - file: overview/definitions
     - file: overview/what-we-catalogue
+    - file: overview/fair
   - caption: Search
     chapters:
     - file: search/searching

TeSS_docs/images/overview/metadata-source.png

@@ -0,0 +1,37 @@
+# How we support FAIR
+
+Training materials and events are widely dispersed and fragmented, making it challenging for users to identify relevant materials. 
+Training e-Support System (TeSS) is a web-based open-source platform consolidating resources from various providers into an easy-to-use portal. 
+It is a one-stop-shop for trainers and trainees to discover training materials, workshops, and online courses in relevant topics such as data management and open research methods.
+
+For providers, the TeSS Platform makes it easy to make resources [FAIR](http://doi.org/10.1038/sdata.2016.18) (Findable, Accessible, Interoperable, and Reusable):
+
+- **Findable**:  PID/DOI is requested for all materials
+- **Accessible**: TeSS materials/events are accessible to all registered users via the TeSS website, widgets or JSON API
+- **Interoperable**: Metadata uses a standard vocabulary (EDAM for ELIXIR), expose content using Schema.org
+- **Reusable**: License is requested for all materials
+
+
+## Exposed metadata behind each page
+
+When you view a material or event on TeSS, there is machine-readable metadata behind the human-readable content. 
+If you were to view the HTML source of the page, you would see this code, written in JSON-LD format.  
+
+```{image} ../images/overview/metadata-source.png
+:alt: View Source to see the embedded metadata
+:class: mb-1
+:width: 300px
+:align: center
+```
+
+Developers can access this metadata, without the human-readable HTML content, by appending `.jsonld` to the URL. 
+For example:
+
+```
+https://tess.elixir-europe.org/materials/how-to-make-your-messy-data-usable-openrefine
+```
+
+...becomes
+```
+https://tess.elixir-europe.org/materials/how-to-make-your-messy-data-usable-openrefine.jsonld
+```