diff --git a/MetadataGuide.html b/MetadataGuide.html index bac2625..4847f23 100644 --- a/MetadataGuide.html +++ b/MetadataGuide.html @@ -377,7 +377,7 @@
License: CC BY 4.0 Deed Attribution 4.0 International
+License: CC BY 4.0 Deed Attribution 4.0 International
Zenodo archive: https://www.doi.org/10.5281/zenodo.11103071
SHACL validation rules:
sh:nodeKind sh:IRI
If your ontology has been published at an archive, you may want to declare these related identifiers in the ontology metadata.
+If your ontology has been published at an archive, you may want to declare these related identifiers in the ontology metadata. You should list here alternative URIs that may be used to identify your ontology. The identifier used as the base URI of the ontology should be provided with http://purl.org/vocab/vann/preferredNamespaceUri instead (cf. 5.20 Preferred ontology namespace).
Recommended property: http://purl.org/dc/terms/identifier
Example (text/turtle):
<https://www.purl.org/SomeOntology> rdf:type owl:Ontology ;
@@ -1382,6 +1383,7 @@ 5.15 Related identifiers
- http://purl.org/ontology/bibo/doi
- https://schema.org/identifier
+- http://purl.org/dc/elements/1.1/identifier>
SHACL validation rules:
@@ -1502,6 +1504,7 @@ 5.22 Modification date
5.23 Textual version information
Some ontologies make use of semantic versioning and employ strings like 1.0.0 as a tag to distinguish one version of their ontology from a successor. Others employ the modification date, e.g. 2022-12-21. If you use such textual version information but do not use/have a Version URI, then we strongly recommend to also mint a version URI in which you use the textual version information as variable.
+If you need to add a larger comment in natural language, you should provide the info as an rdf:langString, i.e. with a language tag. We do not encourage this, since such statements can most likely be expressed in more granular fashion with formal statements. Alternatively, you could add the info to the version notes (cf. 5.24 Version notes).
Recommended property: http://www.w3.org/2002/07/owl#versionInfo
Example 1 (text/turtle):
<https://www.purl.org/SomeOntology> rdf:type owl:Ontology ;
@@ -1511,13 +1514,18 @@ 5.23 Textual version information
<https://www.purl.org/SomeOntology> rdf:type owl:Ontology ;
owl:versionInfo "1.0.0"^^xsd:string .
+Example 3 (text/turtle)
+:
+<https://www.purl.org/SomeOntology> rdf:type owl:Ontology ;
+ owl:versionInfo "Ontology version 1.0.0 of the subject classification in tabular format from Nov 2024."@en.
+
Alternative properties:
SHACL validation rules:
-sh:datatype xsd:string
+sh:xone ([sh:datatype xsd:string ;] [sh:datatype rdf:langString ;])
sh:maxCount 1
5.24 Version notes
diff --git a/MetadataGuide.md b/MetadataGuide.md
index e250b55..e134243 100644
--- a/MetadataGuide.md
+++ b/MetadataGuide.md
@@ -13,7 +13,7 @@ Creators and contributors:
* [Strömert, Philip (Technische Informationsbibliothek)](https://orcid.org/0000-0002-1595-3213)
* [Vogt, Lars (Technische Informationsbibliothek)](https://orcid.org/0000-0002-8280-0487)
-License: [CC BY 4.0 Deed Attribution 4.0 International ](https://creativecommons.org/licenses/by/4.0/)
+License: [CC BY 4.0 Deed Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/)
Zenodo archive:
@@ -76,7 +76,7 @@ Zenodo archive:
* [5.12 Example ontology class](#512-example-ontology-class)
* [5.13 Ontology mailing list](#513-ontology-mailing-list)
* [5.14 Ontology logo/ depictions/ related visualization](#514-ontology-logo-depiction-related-visualizations)
- * [5.15 Related identifiers](#515-related-identifiers)
+ * [5.15 Alternative identifiers of the ontology](#515-alternative-identifiers-of-the-ontology)
* [5.16 Development environment](#516-development-environment)
* [5.17 Alignments/ mappings](#517-alignments-mappings)
* [5.17.1 Aligned resources](#5171-aligned-resources)
@@ -268,6 +268,7 @@ Alternative properties:
*
*
*
+* (is a mis-spelled variant of )
SHACL validation rules:
@@ -1235,9 +1236,9 @@ SHACL validation rules:
* `sh:nodeKind sh:IRI`
-### 5.15 Related identifiers
+### 5.15 Alternative identifiers of the ontology
-If your ontology has been published at an archive, you may want to declare these related identifiers in the ontology metadata.
+If your ontology has been published at an archive, you may want to declare these related identifiers in the ontology metadata. You should list here alternative URIs that may be used to identify your ontology. The identifier used as the base URI of the ontology should be provided with instead (cf. [5.20 Preferred ontology namespace](#520-preferred-ontology-namespace)).
Recommended property:
@@ -1252,6 +1253,7 @@ Alternative properties:
*
*
+* >
SHACL validation rules:
@@ -1432,6 +1434,8 @@ SHACL validation rules:
Some ontologies make use of semantic versioning and employ strings like 1.0.0 as a tag to distinguish one version of their ontology from a successor. Others employ the modification date, e.g. 2022-12-21. If you use such textual version information but do not use/have a Version URI, then we strongly recommend to also mint a version URI in which you use the textual version information as variable.
+If you need to add a larger comment in natural language, you should provide the info as an rdf:langString, i.e. with a language tag. We do not encourage this, since such statements can most likely be expressed in more granular fashion with formal statements. Alternatively, you could add the info to the version notes (cf. [5.24 Version notes](#524-version-notes)).
+
Recommended property:
Example 1 (text/turtle):
@@ -1448,13 +1452,21 @@ Example 2 (text/turtle):
owl:versionInfo "1.0.0"^^xsd:string .
```
+Example 3 (text/turtle)
+:
+
+```Turtle
+ rdf:type owl:Ontology ;
+ owl:versionInfo "Ontology version 1.0.0 of the subject classification in tabular format from Nov 2024."@en.
+```
+
Alternative properties:
*
SHACL validation rules:
-* `sh:datatype xsd:string`
+* `sh:xone ([sh:datatype xsd:string ;] [sh:datatype rdf:langString ;])`
* `sh:maxCount 1`
### 5.24 Version notes
diff --git a/MetadataGuide.pdf b/MetadataGuide.pdf
index f5a80a0..967c10e 100644
Binary files a/MetadataGuide.pdf and b/MetadataGuide.pdf differ
diff --git a/OntoMetadataShape.ttl b/OntoMetadataShape.ttl
index 76dabad..97921ff 100644
--- a/OntoMetadataShape.ttl
+++ b/OntoMetadataShape.ttl
@@ -223,7 +223,7 @@ ontometa:OntologyMetadataShape a sh:NodeShape ;
] ;
sh:property [
- sh:path [sh:alternativePath (dcterms:license dcterms:rights schema:license cc:license dbo:license)] ;
+ sh:path [sh:alternativePath (dcterms:license dcterms:rights schema:license cc:license dbo:license )] ;
sh:severity sh:Warning ;
# tbd/todo: add further licenses to the list of unaccepted licenses?
# tbd/todo: discuss > redundant test?