Skip to content

Commit adc9826

Browse files
committed
Improve descriptions of Linked Data
1 parent b716636 commit adc9826

2 files changed

Lines changed: 6 additions & 6 deletions

File tree

TeSS_docs/developers/code-data.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,9 +50,10 @@ https://tess.elixir-europe.org/events.json_api
5050
https://tess.elixir-europe.org/materials.json_api?scientific_topics=RNA-Seq
5151
https://tess.elixir-europe.org/content_providers.json_api
5252
https://tess.elixir-europe.org/workflows.json_api
53+
https://tess.elixir-europe.org/materials/how-to-make-your-messy-data-usable-openrefine.json_api
5354
```
5455

55-
To get direct access to the metadata on individual materials or events, append `.jsonld` instead:
56+
To get [Bioschemas](https://bioschemas.org) JSON-LD representation of individual materials or events, append `.jsonld` instead:
5657

5758
```
5859
https://tess.elixir-europe.org/materials/how-to-make-your-messy-data-usable-openrefine.jsonld

TeSS_docs/overview/fair.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,14 @@ For providers, the TeSS Platform makes it easy to make resources [FAIR](http://d
88

99
- **Findable**: A unique, persistent identifier such as [DOI](https://www.doi.org/the-identifier/what-is-a-doi/) is requested for all materials. (For example, [publish your materials in Zenodo](https://help.zenodo.org/docs/get-started/quickstart/) to be assigned a DOI.)
1010
- **Accessible**: TeSS materials/events are accessible to all registered users via the TeSS website, [widgets](../developers/code-data) or [JSON API](../developers/code-data). Your content will seen more in search results owing to our search-engine optimisation (SEO).
11-
- **Interoperable**: Metadata uses a standard vocabulary (EDAM for ELIXIR). We expose content using Schema.org (Bioschemas) and OAI-PMH open standards.
11+
- **Interoperable**: Metadata uses a standard vocabulary (EDAM for ELIXIR). We expose content using Schema.org (Bioschemas), JSON-LD, and OAI-PMH open standards.
1212
- **Reusable**: License is requested for all materials, such as Creative Commons.
1313

1414

15-
## Exposed metadata behind each page
15+
## Interoperate using Linked Data
1616

1717
When you view a material or event on TeSS, there is machine-readable metadata behind the human-readable content.
18-
If you were to view the HTML source of the page, you would see this code, written in JSON-LD format.
18+
If you were to view the HTML source of the page, you would see this code, written as [JSON-LD](https://json-ld.org/).
1919

2020
```{image} ../images/overview/metadata-source.png
2121
:alt: View Source to see the embedded metadata
@@ -24,8 +24,7 @@ If you were to view the HTML source of the page, you would see this code, writte
2424
:align: center
2525
```
2626

27-
Developers can access this metadata, without the human-readable HTML content, by appending `.jsonld` to the URL.
28-
For example:
27+
Developers can access this [Bioschemas](https://bioschemas.org)-compliant JSON-LD metadata, without the human-readable HTML, to use interoperate as [Linked Data](https://en.wikipedia.org/wiki/Linked_data). To do this, append `.jsonld` to the URL. For example:
2928

3029
```
3130
https://tess.elixir-europe.org/materials/how-to-make-your-messy-data-usable-openrefine

0 commit comments

Comments
 (0)