First skeleton of docs overwork, still much content to fill in.

docs/README.md

@@ -8,6 +8,6 @@ jupyter-book build docs
 ```
 
 Also ideally the terms should go somewhere else and be automatically included in this.
-The same goes for code documenation of the pipelines and their usage.
+The same goes for code documentation of the pipelines and their usage.
 
 

docs/_config.yml

@@ -14,6 +14,10 @@ exclude_patterns            : [_build, Thumbs.db, .DS_Store, "**.ipynb_checkpoin
 # Auto-exclude files not in the toc
 only_build_toc_files        : false
 
+
+bibtex_bibfiles:
+    - references.bib
+    
 #######################################################################################
 # Execution settings
 execute:
@@ -81,7 +85,8 @@ repository:
   url                       : https://codebase.helmholtz.cloud/hmc/hmc-public/unhide/documentation  # The URL to your book's repository
   path_to_book              : docs  # A path to your book's folder, relative to the repository root.
   branch                    : main  # Which branch of the repository should be used when creating links
-
+  provider                  : gitlab
+ 
 #######################################################################################
 # Advanced and power-user settings
 sphinx:
@@ -89,3 +94,5 @@ sphinx:
   local_extensions          :   # A list of local extensions to load by sphinx specified by "name: path" items
   recursive_update          : false # A boolean indicating whether to overwrite the Sphinx config (true) or recursively update (false)
   config                    :   # key-value pairs to directly over-ride the Sphinx configuration
+    html_theme_options:
+      repository_provider: custom

docs/_toc.yml

@@ -2,7 +2,66 @@
 # Learn more at https://jupyterbook.org/customize/toc.html
 
 format: jb-book
-root: intro
-chapters:
-- file: implementation
-- file: data_sources
+root: landingpage.md
+
+parts:
+   - caption: Introduction
+     numbered: False
+     chapters:
+       - file: introduction/about.md
+         title: "About"
+       - file: introduction/implementation.md
+         title: "Implementation overview"
+       - file: introduction/data_sources.md
+   - caption: Data in UnHIDE
+     numbered: False
+     chapters:
+       - file: data/overview.md
+         title: "Overview"
+       - file: data/dataset.md
+         title: "Dataset"
+       - file: data/documents.md
+         title: "Documents"
+       - file: data/experts.md
+         title: "Experts"
+       - file: data/Institutions.md
+         title: "Institution"
+       - file: data/Instruments.md
+         title: "Instruments"
+       - file: data/software.md
+         title: "Software"
+       - file: data/training.md
+         title: "Training"
+   - caption: Technical implementation
+     numbered: False
+     chapters:
+       - file: tech/harvesting.md
+         title: "Data Harvesting"
+       - file: tech/uplifting.md
+         title: "Data uplifting"
+       - file: tech/indexing.md
+         title: "Data indexing"
+       - file: tech/backend.md
+         title: "Backend overview"
+   - caption: Interacting with UnHIDE data
+     numbered: False
+     chapters:
+       - file: interfaces/usecases.md
+         title: "Use case examples"
+       - file: interfaces/web.md
+         title: "Web search"
+       - file: interfaces/sparql.md
+         title: "SPARQL endpoint"
+       - file: interfaces/api.md
+         title: "REST API"
+   - caption: Related Knowledge
+     numbered: False
+     chapters:
+       - file: knowledge/overview.md
+         title: "Structured data on the web"
+       - file: knowledge/tools.md
+         title: "Tools around Linked Data"
+       - file: knowledge/other_graphs.md
+         title: "Other Graphs"
+
+

docs/data/Institutions.md

+# Institutions
+
+Metadata template for institutions. This is just schema.org organizations.
+UnHIDE extracts these from individual records and it tries to uplifted this data with metadata provided
+with ROR as well as orcid.
+
+```{literalinclude} ./graphs/institutionTemplate.json
+:linenos:
+```

docs/data/Instruments.md

+# Instruments
+
+Metadata template for Instruments:
+
+```{literalinclude} ./graphs/instrumentTemplate.json
+:linenos:
+```

docs/data/dataset.md

+# Dataset
+
+```{literalinclude} ./graphs/datasetTemplate.json
+:linenos:
+```

docs/data/documents.md

+# Documents
+
+
+Metadata template for Documents, which is a combined category from the schema.org terms:
+[CreativeWork](https://schema.org/CreativeWork), [DigitalDocument](https://schema.org/DigitalDocument), [Thesis](https://schema.org/Thesis), [Report](https://schema.org/Report), [Article](https://schema.org/Article), ...
+
+So this all entries of these types will end up in the 'Document' search bucket.
+
+
+Be aware that this category may contain also entries which are in reality no documents but typed in the metadata 
+by the high level schema.org class 'CreateWork'.
+
+```{literalinclude} ./graphs/documentTemplate.json
+:linenos:
+```

docs/data/experts.md

+# Experts
+
+The expert category contains Persons and and Institutions combined, which are extracted from individual records.
+
+
+```{literalinclude} ./graphs/expertTemplate.json
+:linenos:
+```

docs/data/graphs/datasetTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/graphs/expertTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/graphs/institutionTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/graphs/instrumentTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/graphs/softwareTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/graphs/trainingTemplate.json

+{
+    "@context": {
+        "@vocab": "https://schema.org/"
+    },
+    "@type": "Dataset",
+    "@id": "https://registry.org/permanentUrlToThisJsonDoc",
+    "name": "A concise but descriptive name of the dataset",
+    "description": "An extended, free-text description of what's in the dataset, who created it, and other attributes",
+    "url": "https://urlToTheDatasetOrLandingPage.org/",
+    "sameAs": [
+        "http://alternativeUrlToTheDatasetOrLandingPage.org"
+    ],
+    "license": "This work is licensed under a  Creative Commons Attribution (CC-BY) 4.0 License",
+    "citation": [
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset",
+        "Citation to other work relevant to this dataset"
+    ],
+    "version": "2021-04-24T06:34:56.000Z",
+    "keywords": [
+        "Keyword 1",
+        "Keyword 2",
+        "Keyword 3"
+    ],
+    "measurementTechnique": "The URL to or text about the methods, technique or technology used to generate this Dataset",
+    "variableMeasured": [
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "description": "Extended description of this variable"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "Name of a variable in the dataset",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable?"
+        },
+        {
+            "@type": "PropertyValue",
+            "name": "SamplingDeviceApertureSurfaceArea",
+            "url": "http://ontology.org/uriToSemanticDescriptorOfThisVariable",
+            "description": "Extended description of this variable"
+        }
+    ],
+    "includedInDataCatalog": {
+        "@id": "https://registryOfCatalogs.org/permanentUrlIdentifiyingCatalog",
+        "@type": "DataCatalog",
+        "url": "https://urlOfDataCatalog.org"
+    },
+    "temporalCoverage": "2007/2007",
+    "distribution": {
+        "@type": "DataDownload",
+        "contentUrl": "http://urlToDirectDownloadOfThisDataset.org/",
+        "encodingFormat": "text/csv"
+    },
+    "spatialCoverage": {
+        "@type": "Place",
+        "geo": {
+            "@type": "GeoShape",
+            "polygon": "142.014 10.161667,142.014 18.033833,147.997833 18.033833,147.997833 10.161667,142.014 10.161667"
+        },
+        "additionalProperty": {
+            "@type": "PropertyValue",
+            "propertyID": "http://dbpedia.org/resource/Spatial_reference_system",
+            "value": "http://www.w3.org/2003/01/geo/wgs84_pos#lat_long"
+        }
+    },
+    "provider": [
+        {
+            "@type": "Organization",
+            "legalName": "Legal Name of Organisation which generated the dataset",
+            "name": "Other Name of Organisation which generated the dataset",
+            "url": "https://organisationWebsite.org/"
+        }
+    ],
+    "subjectOf": {
+        "@type": "Event",
+        "description": "Describe the event which is the subject of this dataset. For example, a cruise ID.",
+        "name": "Concise and descriptive name of the Event",
+        "potentialAction": {
+            "@type": "Action",
+            "name": "Concise but descriptive name of action that was part of an Event. For example, the name of a CTD cast",
+            "agent": [
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action",
+                "Name or permanent ID of person or thing that performed this action"
+            ],
+            "startTime": "2007-03-11T14:45UTC",
+            "endTime": "2007-03-11T15:42UTC",
+            "instrument": {
+                "@type": "Thing",
+                "name": "The name of the instrument used in the action. For example, the specific model of a CTD, a glider, a moored sensor",
+                "url": "http://ontology.org/uriToSemanticDescriptorOfThisInstrument",
+                "description": "Extended description of the sampling instrument"
+            }
+        }
+    }
+}

docs/data/overview.md

+# Overview of (meta)data in UnHIDE
+
+
+
+
+## Interoperability Metadata templates
+
+UnHIDE can digest metadata in the form of a well established standard on the web: metadata using schema.org semantics.
+However, schema.org is due to its history often very general so for some cases extensions to it are needed.
+
+These are currently maintained by a community constructing similar graphs and it important to use these, to ensure interoperability.
+
+Here you find a detailed listing of 
+
+
+
+## How much data is there
+
+
+what how much data is in there..
\ No newline at end of file

docs/data/software.md

+# Software
+
+Metadata template for Software. UnHIDE uses here the schema.org extension of the [codemeta project](https://codemeta.github.io/).
+
+In the frond end search category Software 
+
+```{literalinclude} ./graphs/softwareTemplate.json
+:linenos:
+```

docs/data/training.md

+# Training
+
+Metadata template for training events.
+
+```{literalinclude} ./graphs/trainingTemplate.json
+:linenos:
+```