search

hitontology / ontology

The Health IT Ontology.
https://hitontology.eu/
Creative Commons Zero v1.0 Universal
3 stars 2 forks source link

HITOntology Description of Content ontology widoco #83

Closed KonradHoeffner closed 2 years ago

KonradHoeffner commented 3 years ago

@MichelleBindel sammelt Erklärungen und Beispiele in https://docs.google.com/document/d/1u-kJwPbJMqoLbJFybO6bcjkLdqKcoPmB_M7iM-uNPl4/edit#. @KonradHoeffner informiert sich, wie man w3c-artige Dokumente wie https://www.w3.org/TR/skos-reference/ erstellt und formatiert das dann und stellt es auf die Webseite.

KonradHoeffner commented 3 years ago

Ist zwar von 2011 aber hier werden verschiedene Ontologiedokumentationstools vorgestellt: https://www.w3.org/2011/prov/wiki/Generating_HTML_documentation_of_OWL

KonradHoeffner commented 3 years ago

Widoco

Widoco is a Java tool that generates HTML documentation for OWL2 vocabularies

Widoco result prototype is available at https://hitontology.github.io/ontology/index-en.html

In order to improve the information available there, add the missing information to the ontology itself.

KonradHoeffner commented 3 years ago

Die Lizenz (license) muss noch bestimmt werden in Issue https://github.com/hitontology/ontology/issues/82.

KonradHoeffner commented 3 years ago

Die neueste Version mit allen Daten aus dem Google Docs Dokument ist jetzt online unter https://hitontology.github.io/ontology/index-en.html. Das Google Docs Dokument bitte nicht mehr weiter pflegen, da ich jetzt durch bin und nicht merke, wenn dort etwas geändert wurde, außerdem ist der Transfer in das richtige Format sehr zeitaufwändig.

Daher bitte ab jetzt direkt in die hito.ttl eintragen. Hier ist die Dokumentation, welche Attribute benutzt werden: https://dgarijo.github.io/Widoco/doc/bestPractices/index-en.html.

Das widoco akzeptiert Beispiele nur als URIs, nicht als Strings. Habe jetzt ein paar reingestellt aber es fehlen noch welche. Die ersten paar Klassen haben noch keine Beschreibung, das hab ich vergessen im IMISE zu pushen gestern, das kommt Montag, bin heute im Homeoffice. Manche Beschreibungen klingen noch etwas komisch, und wir sollten das z.B. bei Citation, Classified und Catalogue vereinheitlichen.

Instanzen habe ich jetzt erstmal rausgenommen (außer als Beispiele), da es ja eine Ontologiedokumentation ist, oder seht ihr das anders?

KonradHoeffner commented 3 years ago

Für Citations zu papers schlage ich DOI URIs vor, da die stabil sein sollten.

KonradHoeffner commented 3 years ago

The ontology documentation https://hitontology.github.io/ontology/index-en.html is in a usable state now.

KonradHoeffner commented 3 years ago

@vdornauer: Bitte descriptions von den folgenden Klassen geben:

KonradHoeffner commented 3 years ago

@MichelleBindel:

KonradHoeffner commented 2 years ago

Added the descriptions ad hoc now to get this wrapped up. Feel free to improve them if you don't agree with any one of them.