Merge pull request #72 from nfdi4plants/ontology

First draft of Shared Vocabulary page

src/components/Home/ResearchGraphNavigation.astro

@@ -6,7 +6,7 @@ import { Color } from "../GraphNavigation.astro";
 const circles = [
   { id: 1, cx: 8, cy: 10, r: 5, href: URLS.INTERNAL_COM_DOCUMENTATION, text: 'Documentation Principle', angle: 80 },
   { id: 2, cx: 30, cy: 40, r: 5, href: URLS.INTERNAL_COM_ORGANIZATION, text: 'Organization Principle', angle: 200 },
-  { id: 3, cx: 60, cy: 35, r: 5, href: '#', text: 'Quality Control', angle: 130 },
+  { id: 3, cx: 60, cy: 35, r: 5, href: URLS.INTERNAL_COM_ONTOLOGY, text: 'Shared Vocabulary', angle: 130 },
   { id: 4, cx: 90, cy: 15, r: 5, href: URLS.INTERNAL_COM_PUBLICATION, text: 'Publication & Exchange', angle: 10 },
   { id: 5, cx: 140, cy: 25, r: 5, href: URLS.INTERNAL_COM_FAIRNESS, text: 'RDM & FAIRness', angle: 210 },
 ];

src/components/Navbar.astro

@@ -15,7 +15,7 @@ const links: Link[] = [
     {text: "More", children: [
       {href: URLS.INTERNAL_COM_DOCUMENTATION, text: "Documentation Principle"},
       {href: URLS.INTERNAL_COM_ORGANIZATION, text: "Organization Principle"},
-      {href: "#", text: "quality control 🚧"},
+      {href: URLS.INTERNAL_COM_ONTOLOGY, text: "Shared Vocabulary"},
       {href: URLS.INTERNAL_COM_PUBLICATION, text: "Publication & Exchange"},
       {href: URLS.INTERNAL_COM_FAIRNESS, text: "RDM & FAIRness"},
     ]},

src/pages/details/shared-vocabulary.md

@@ -0,0 +1,31 @@
+---
+layout: ../../layouts/MarkdownLayout.astro
+title: 'Shared Vocabulary, Shared Comprehension'
+pubDate: 2024-09-10
+description: 'Controlled Vocabularies play a major role at the ARC, allowing for an explicit description of an unrestricted range.'
+author: 'Heinrich Lukas Weil'
+image:
+    url: 'https://docs.astro.build/assets/rose.webp'
+    alt: 'The Astro logo on a dark background with a pink glow.'
+tags: ["ontology", "annotation", "isa"]
+---
+
+Shared comprehension is one of the main goals in making research FAIR. Only datasets that can be understood, can be reused, multiplying their worth. 
+For this, using terminology with well-defined meanings is one key step. The ARC enables and encourages usage of such terms stemming from controlled vocabularies and ontologies. 
+
+![Structural-and-Semantic-Ontology](/ontology-connection.png)
+
+Flexibility is achieved by combining an ARC-specific container ontology providing structure with terms coming from other ontologies, providing information specific to the experimental setup. 
+
+## Providing terminology guidance
+
+Any term stemming from any controlled vocabulary is allowed to be used in the ARC. Picking the right term can sometimes be difficult because of the amount of different vocabularies that exist. 
+To ease this initial superabundance of possibilites, streamline the picked terms and guide the user to use high-quality term collection, the ARC tool framework features a curated ontology collection.
+
+## Harnessing ontological reasoning
+
+Using terms picked from well-maintained ontologies offers other advantages than just the controlled definitions and naming of the terms themselves. Through ontological reasoning, predefined connections between terms can be automatically interpreted.
+
+![Ontology Term Mapping](/ontology-conversion.png)
+
+This allows providing a controlled set of terms agnostic to the specifics of the experimental context. By having these terms ontologically connected to their counterparts in experiment specific ontologies used in end-point repositories, even generic ARCs can be automatically mapped to these end-point repositories.

src/pages/dictionary/ontology.md

@@ -0,0 +1,21 @@
+---
+layout: ../../layouts/DictionaryPageLayout.astro
+title: 'Ontologies'
+pubDate: 2024-09-16
+description: 'A collection of concepts and their relationships for a specific domain.'
+author: 'Heinrich Lukas Weil'
+image:
+    url: 'https://docs.astro.build/assets/rose.webp'
+    alt: 'The Astro logo on a dark background with a pink glow.'
+tags: ["specification", "services", "community"]
+keywords: ["Ontology", "Controlled Vocabulary", "Ontology Term"]
+url: "ontology"
+---
+
+
+## Controlled Vocabulary vs Ontology
+
+## Representation
+
+
+Find out more about Ontologies on [ontotext.com](https://www.ontotext.com/knowledgehub/fundamentals/what-are-ontologies/).

src/statics.ts

@@ -13,6 +13,7 @@ export enum URLS {
   INTERNAL_COM_TOOLS = BASE_PATH + "details/tools-and-services",
   INTERNAL_COM_RESOURCES = BASE_PATH + "details/resources",
   INTERNAL_COM_DOCUMENTATION = BASE_PATH + "details/documentation-principle",
+  INTERNAL_COM_ONTOLOGY = BASE_PATH + "details/shared-vocabulary",
   INTERNAL_COM_ORGANIZATION = BASE_PATH + "details/organization-principle",
   INTERNAL_COM_PUBLICATION = BASE_PATH + "details/exchange-and-publication",
   INTERNAL_COM_FAIRNESS = BASE_PATH + "details/fairness-and-rdm",