Skip to content

Commit

Permalink
#6 corrections (vann namespace), removal of redundant lines, update o…
Browse files Browse the repository at this point in the history
…f docs
  • Loading branch information
SArndt-TIB committed Dec 12, 2024
1 parent 389783c commit 4b9e62a
Show file tree
Hide file tree
Showing 8 changed files with 29 additions and 108 deletions.
2 changes: 1 addition & 1 deletion DummyOntoPASSES.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
<http://purl.org/ontology/bibo/status> "active"@en ;
doap:repository <https://github.com/StroemPhi/Ontology-Metadata> ;
<http://www.w3.org/ns/dcat#distribution> <https://www.purl.org/ontologymetadata/DummyOntoPASSES.owl> ;
<https://vocab.org/vann/example> <https://www.purl.org/ontologymetadata/DummyOntoPASSES/docs/descriptionOfUse> ;
<http://purl.org/vocab/vann/example> <https://www.purl.org/ontologymetadata/DummyOntoPASSES/docs/descriptionOfUse> ;
dcterms:isReferencedBy <https://zenodo.org/record/0000000> ;
dcterms:bibliographicCitation "TIB (2023): DummyOntoPASSES. An ontology demonstrating rich ontology metadata. PURL: https://www.purl.org/ontologymetadata/DummyOntoPASSES."@en ;
pav:derivedFrom <http://www.purl.org/SomeOtherOntology/0.0.1> ;
Expand Down
8 changes: 4 additions & 4 deletions MetadataGuide.html
Original file line number Diff line number Diff line change
Expand Up @@ -1045,7 +1045,7 @@ <h3 id="411-ontology-distributions-products">4.11 Ontology distributions/ produc
</ul>
<h3 id="412-application-example">4.12 Application example</h3>
<p>How to use an ontology is often helpfully demonstrated by application examples and visualizations that give a glimpse about how the ontology can be used to structure actual data. If you have such application examples, these might be better found, if you link to them from the ontology. These application examples could be part of the ontology documentation, formal serializations applying the ontology or even technical applications that make use of the ontology.</p>
<p>Recommended property: <a href="https://vocab.org/vann/example">https://vocab.org/vann/example</a></p>
<p>Recommended property: <a href="http://purl.org/vocab/vann/example">http://purl.org/vocab/vann/example</a></p>
<p>Example (text/turtle):</p>
<pre class="hljs"><code><div>&lt;http://www.w3.org/ns/dcat&gt; rdf:type owl:Ontology ;
vann:example &lt;https://www.w3.org/TR/vocab-dcat-2/#collection-of-examples&gt; .
Expand Down Expand Up @@ -1100,7 +1100,7 @@ <h3 id="415-ontology-sources-derived-from">4.15 Ontology sources (derived from)<
<li><code>sh:nodeKind sh:IRI</code></li>
</ul>
<h3 id="416-ontology-root-classes">4.16 Ontology root classes</h3>
<p>You should explicitly declare the ontology's preferred root classes. Display tools like the <a href="https://terminology.tib.eu/ts" title="TIB Terminology Service. URL: https://terminology.tib.eu/. Last accessed: 22 April 2024.">TIB Terminology Service</a> and other OLS-based services <a href="#source9">[9]</a>, <a href="#source10">[10]</a> can pick specific, user-defined classes for rendering the ontology class hierarchy. This is especially helpful, when an ontology imports a lot of classes from other ontologies. The repsective classes need to be provided via their identifier.</p>
<p>You should explicitly declare the ontology's preferred root classes. Display tools like the <a href="https://terminology.tib.eu/ts" title="TIB Terminology Service. URL: https://terminology.tib.eu/. Last accessed: 22 April 2024.">TIB Terminology Service</a> and other OLS-based services <a href="#source9">[9]</a>, <a href="#source10">[10]</a> can pick specific, user-defined classes for rendering the ontology class hierarchy. This is especially helpful, when an ontology imports a lot of classes from other ontologies. The respective classes need to be provided via their identifier.</p>
<p>Recommended property: <a href="http://purl.obolibrary.org/obo/IAO_0000700">http://purl.obolibrary.org/obo/IAO_0000700</a></p>
<p>Example (text/turtle):</p>
<pre class="hljs"><code><div>&lt;https://www.purl.org/SomeOntology&gt; rdf:type owl:Ontology ;
Expand Down Expand Up @@ -1539,7 +1539,7 @@ <h3 id="524-version-notes">5.24 Version notes</h3>
</div></code></pre>
<p>Alternative properties:</p>
<ul>
<li><a href="https://vocab.org/vann/changes">https://vocab.org/vann/changes</a></li>
<li><a href="http://purl.org/vocab/vann/changes">http://purl.org/vocab/vann/changes</a></li>
</ul>
<p>SHACL validation rules:</p>
<ul>
Expand Down Expand Up @@ -1744,7 +1744,7 @@ <h2 id="6-tabular-overview">6 Tabular overview</h2>
<tr>
<td>4.12</td>
<td>Application example</td>
<td><a href="https://vocab.org/vann/example">https://vocab.org/vann/example</a></td>
<td><a href="http://purl.org/vocab/vann/example">http://purl.org/vocab/vann/example</a></td>
<td></td>
<td>x</td>
<td></td>
Expand Down
6 changes: 3 additions & 3 deletions MetadataGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -758,7 +758,7 @@ SHACL validation rules:

How to use an ontology is often helpfully demonstrated by application examples and visualizations that give a glimpse about how the ontology can be used to structure actual data. If you have such application examples, these might be better found, if you link to them from the ontology. These application examples could be part of the ontology documentation, formal serializations applying the ontology or even technical applications that make use of the ontology.

Recommended property: <https://vocab.org/vann/example>
Recommended property: <http://purl.org/vocab/vann/example>

Example (text/turtle):

Expand Down Expand Up @@ -1487,7 +1487,7 @@ Example (text/turtle):

Alternative properties:

* <https://vocab.org/vann/changes>
* <http://purl.org/vocab/vann/changes>

SHACL validation rules:

Expand Down Expand Up @@ -1520,7 +1520,7 @@ SHACL validation rules:
| 4.9 | Status | <http://purl.org/ontology/bibo/status> | | x | | 0...1 |
| 4.10 | Code repository | <http://usefulinc.com/ns/doap#repository> | | x | | 0...1 |
| 4.11 | Distributions/ products | <http://www.w3.org/ns/dcat#distribution> | | x | | 0…* |
| 4.12 | Application example | <https://vocab.org/vann/example> | | x | | 0…* |
| 4.12 | Application example | <http://purl.org/vocab/vann/example> | | x | | 0…* |
| 4.13 | Related resource(s) | <http://purl.org/dc/terms/references> | | x | | 0…* |
| 4.14 | Citation suggestion | <http://purl.org/dc/terms/bibliographicCitation> | | x | | 0…* |
| 4.15 | Ontology sources (derived from) | <http://purl.org/pav/derivedFrom> | | x | | 0…* |
Expand Down
Binary file modified MetadataGuide.pdf
Binary file not shown.
Loading

0 comments on commit 4b9e62a

Please sign in to comment.