Based on out discussions in the EMMC taskforce on ontology documentation and demonstration we have defined some suggestion to improve the general procedure and guidelines how to document EMMO entities.
The goal is to define recommended annotation properties and when to use them as well as consolidating the current set of annotation properties to be more in line with the expectations of many tool developers (in general they expect reuse of existing terms in favor of custom properties, see also here). For the latter it is also suggested to process release files in that way that more specific annotations are duplicated using the base property (e. g. _:a emmo:elucidation “…” => _:a rdfs:comment “…”)
Property
EMMO elucidation
Suggestion
rdfs:label > skos:prefLabel:
mandatory for all EMMO entities
rdfs:label > skos:altLabel
keep it optional, any other label goes here
rdfs:comment > emmo:elucidation
Short enlightening explanation aimed to facilitate the user in drawing the connection (interpretation) between a OWL entity and the real world object(s) for which it stands.
make it mandatory, make it a subproperty of skos:definition
rdfs:comment > emmo:comment
A text that add some information about the entity.
replace with skos:note; keep it optional, any other comments
rdfs:comment > emmo:example
Illustrative example of how the entity is used.
replace it with skos:example
rdfs:comment > emmo:definition
Precise and univocal description of an ontological entity in the framework of an axiomatic system.
rename to formalDefinition to make it more distinct to skos:definition
rdfs:comment > emmo:figure
A link to a graphical representation aimed to facilitate understanding of the concept, or of an annotation.
make it a subproperty of rdfs:seeAlso
rdfs:comment > emmo:conceptualization
The conceptualisation annotation is a comment that helps the reader to understand how the world has been conceptualised by the ontology authors.
None
rdfs:comment > emmo:etymology
The etymology annotation explains the origin of a word and the historical development of its meaning.
None
rdfs:comment > emmo:contact
A person or organisation acting as a contact point for enquiries about the ontology resource
Based on out discussions in the EMMC taskforce on ontology documentation and demonstration we have defined some suggestion to improve the general procedure and guidelines how to document EMMO entities. The goal is to define recommended annotation properties and when to use them as well as consolidating the current set of annotation properties to be more in line with the expectations of many tool developers (in general they expect reuse of existing terms in favor of custom properties, see also here). For the latter it is also suggested to process release files in that way that more specific annotations are duplicated using the base property (e. g.
_:a emmo:elucidation “…”=>_:a rdfs:comment “…”)