From 4a86c9b9bd0f71f1457adbfb03216c82da998cf6 Mon Sep 17 00:00:00 2001 From: Giacomo Lanza Date: Thu, 17 Aug 2023 13:38:20 +0200 Subject: [PATCH 1/3] add `rdfs:seeAlso` --- doc/metadataGuide/guide.md | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/doc/metadataGuide/guide.md b/doc/metadataGuide/guide.md index dac4f5bc..ce6d5f48 100644 --- a/doc/metadataGuide/guide.md +++ b/doc/metadataGuide/guide.md @@ -72,15 +72,15 @@ The table below shows which ontology metadata annotations are recognized in WIDO The table below summarizes all the metadata annotations recognized for ontology terms, in alphabetical order. Note that there are no `config.properties` annotations here, as these annotations are only read from the ontology file. -|Metadata category |Ontology annotation property |Good practices document |Accepted property value|Example | -|------------------|-------------------------------------------------|---------------------------|-----------------------|-----------------| -|Definition |[rdfs:comment], [skos:definition] |[Sec 4.2] **[RECOMMENDED]**|[Text] |[ontology](#term)| -|Deprecation status|[owl:deprecated] |[Sec 4.5.1] **[OPTIONAL]** |[Boolean] |[ontology](#term)| -|Example |[vann:example], [skos:example] |[Sec 4.4] **[OPTIONAL]** |[Text] |[ontology](#term)| -|Label |[rdfs:label], [skos:prefLabel], [obo:IAO_0000118]|[Sec 4.1] **[RECOMMENDED]**|[Text] |[ontology](#term)| -|Original source |[rdfs:isDefinedBy], [dce:source] |[Sec 4.3] **[OPTIONAL]** |[URI] |[ontology](#term)| -|Rationale |[vaem:rationale] |[Sec 4.6] **[OPTIONAL]** |[Text] |[ontology](#term)| -|Status |[sw:term_status], [obo:IAO_0000114] |[Sec 4.5.2] **[OPTIONAL]** |[Text] |[ontology](#term)| +|Metadata category|Ontology annotation property|Good practices document|Accepted property value|Example| +|-----------------|----------------------------|-----------------------|-----------------------|-------| +|Definition|[rdfs:comment], [skos:definition]|[Sec 4.2] **[RECOMMENDED]**|[Text] |[ontology](#term)| +|Deprecation status|[owl:deprecated] |[Sec 4.5.1] **[OPTIONAL]**|[Boolean]|[ontology](#term)| +|Example|[vann:example], [skos:example] |[Sec 4.4] **[OPTIONAL]** |[Text] |[ontology](#term)| +|Label|[rdfs:label], [skos:prefLabel], [obo:IAO_0000118]|[Sec 4.1] **[RECOMMENDED]**|[Text]|[ontology](#term)| +|Original source|[rdfs:isDefinedBy], [dce:source]|[Sec 4.3] **[OPTIONAL]** |[URI] |[ontology](#term)| +|Rationale|[vaem:rationale] |[Sec 4.6] **[OPTIONAL]** |[Text]|[ontology](#term)| +|Status |[sw:term_status], [obo:IAO_0000114] |[Sec 4.5.2] **[OPTIONAL]**|[Text]|[ontology](#term)| ## Example: Using ontology annotations (Back to table) @@ -144,14 +144,14 @@ If blank nodes are used, then the the result should look similar to the followin ``` Widoco will recognize the following properties when describing agents (persons or organizations): -|Metadata category|Ontology annotation property |Accepted property value | -|-----------------|------------------------------------------------------------|-----------------------------------| -|Affiliation |[schema:affiliation], [org:memberOf] |[Text] or [Organization] or [BNode]| -|Family Name |[schema:familyName], [vcard:family-name], [foaf:family_name]|[Text] | -|Full name |[rdfs:label], [schema:name], [vcard:fn], [foaf:name] |[Text] | -|Given name |[schema:givenName], [vcard:given-name], [foaf:givenname] |[Text] | -|Email |[schema:email], [vcard:hasEmail], [foaf:mbox] |[Text] | -|URL |[schema:url], [vcard:hasURL], [foaf:homepage] |[URI] | +|Metadata category|Ontology annotation property |Accepted property value | +|-----------------|--------------------------------|-----------------------------------| +|Affiliation |[schema:affiliation], [org:memberOf] |[Text] or [Organization] or [BNode]| +|Family Name |[schema:familyName], [vcard:family-name], [foaf:family_name]|[Text] | +|Full name |[rdfs:label], [schema:name], [vcard:fn], [foaf:name] |[Text] | +|Given name |[schema:givenName], [vcard:given-name], [foaf:givenname] |[Text] | +|Email |[schema:email], [vcard:hasEmail], [foaf:mbox] |[Text] | +|URL |[schema:url], [vcard:hasURL], [foaf:homepage] |[URI] | ### Annotating ontology terms: @@ -331,6 +331,7 @@ status=Ontology Specification Draft [rdfs:comment]: http://www.w3.org/2000/01/rdf-schema#comment [rdfs:isDefinedBy]: http://www.w3.org/2000/01/rdf-schema#isDefinedby [rdfs:label]: http://www.w3.org/2000/01/rdf-schema#label +[rdfs:seeAlso] http://www.w3.org/2000/01/rdf-schema#seeAlso [schema:affiliation]: https://schema.org/affiliation [schema:citation]: https://schema.org/citation [schema:contributor]: https://schema.org/contributor From 817d2ad99278f4ed6538041e18418f525cdc4a16 Mon Sep 17 00:00:00 2001 From: "@GLanza" Date: Tue, 12 Dec 2023 16:40:17 +0100 Subject: [PATCH 2/3] preferredNamespaceUri as a literal --- doc/bestPractices/sections/checklist-en.html | 4 ++-- doc/metadataGuide/guide.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/bestPractices/sections/checklist-en.html b/doc/bestPractices/sections/checklist-en.html index 2bed613b..faab43e3 100644 --- a/doc/bestPractices/sections/checklist-en.html +++ b/doc/bestPractices/sections/checklist-en.html @@ -23,7 +23,7 @@
Example:
@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . @prefix vann: <http://purl.org/vocab/vann/> . <https://w3id.org/example> rdf:type owl:Ontology ; - vann:preferredNamespaceUri <https://w3id.org/example#> . + vann:preferredNamespaceUri "https://w3id.org/example" .

Prefix [RECOMMENDED]

@@ -698,7 +698,7 @@
Example:

Status [OPTIONAL]

-Property indicating the usage status of the term. For example, whether the term is mature enough, whether it has been deprecated, curated, etc. Note that some of the properties proposed below, such as obo:IAO_0000114, have as range a set of fixed values. The registry vocabulary proposes a hierarchy of status that may be used to represent terms as well (reg:statusAccepted, reg:statusValid, reg:statusDeprecated, etc.). +Property indicating the usage status of the term. For example, whether the term is mature enough, whether it has been deprecated, curated, etc. Note that some of the properties proposed below, such as obo:IAO_0000114, have as range a set of fixed values. The registry vocabulary proposes a hierarchy of status that may be used to represent terms as well (reg:statusAccepted, reg:statusValid, reg:statusDeprecated, etc.).

    Properties you may use: diff --git a/doc/metadataGuide/guide.md b/doc/metadataGuide/guide.md index f75bfa20..95a010d3 100644 --- a/doc/metadataGuide/guide.md +++ b/doc/metadataGuide/guide.md @@ -129,7 +129,7 @@ The following `Turtle` code block shows sample annotations for each of the metad dct:creator "Daniel Garijo"@en ,"Maria Poveda-Villalon"@en ; dct:license ; vann:preferredNamespacePrefix "exo"@en ; - vann:preferredNamespaceUri> "https://w3id.org/example" ; + vann:preferredNamespaceUri "https://w3id.org/example" ; schema:citation "Cite this vocabulary as: Garijo, D. and Poveda-Villalón, M. The example ontology 1.0.1."@en ; rdfs:comment "An example vocabulary designed to illustrate how to publish vocabularies on the Web following the FAIR principles. This vocabulary describes three simple classes with 3 properties and a data property."@en ; rdfs:label "Example" ; From 4f8af3525a61ac8ca5736a4b6abcf3aee0cd2e74 Mon Sep 17 00:00:00 2001 From: Giacomo Lanza <37865804+Zack-83@users.noreply.github.com> Date: Tue, 12 Dec 2023 16:43:57 +0100 Subject: [PATCH 3/3] Update doc/metadataGuide/guide.md --- doc/metadataGuide/guide.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/doc/metadataGuide/guide.md b/doc/metadataGuide/guide.md index 95a010d3..7fbfe229 100644 --- a/doc/metadataGuide/guide.md +++ b/doc/metadataGuide/guide.md @@ -176,14 +176,14 @@ If blank nodes are used, then the the result should look similar to the followin ``` Widoco will recognize the following properties when describing agents (persons or organizations): -|Metadata category|Ontology annotation property |Accepted property value | -|-----------------|--------------------------------|-----------------------------------| -|Affiliation |[schema:affiliation], [org:memberOf] |[Text] or [Organization] or [BNode]| -|Family Name |[schema:familyName], [vcard:family-name], [foaf:family_name]|[Text] | -|Full name |[rdfs:label], [schema:name], [vcard:fn], [foaf:name] |[Text] | -|Given name |[schema:givenName], [vcard:given-name], [foaf:givenname] |[Text] | -|Email |[schema:email], [vcard:hasEmail], [foaf:mbox] |[Text] | -|URL |[schema:url], [vcard:hasURL], [foaf:homepage] |[URI] | +|Metadata category|Ontology annotation property |Accepted property value | +|-----------------|------------------------------------------------------------|-----------------------------------| +|Affiliation |[schema:affiliation], [org:memberOf] |[Text] or [Organization] or [BNode]| +|Family Name |[schema:familyName], [vcard:family-name], [foaf:family_name]|[Text] | +|Full name |[rdfs:label], [schema:name], [vcard:fn], [foaf:name] |[Text] | +|Given name |[schema:givenName], [vcard:given-name], [foaf:givenname] |[Text] | +|Email |[schema:email], [vcard:hasEmail], [foaf:mbox] |[Text] | +|URL |[schema:url], [vcard:hasURL], [foaf:homepage] |[URI] | ### Annotating ontology terms: