Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve EMMO entity documentation #259

Open
SimonStier opened this issue Nov 25, 2023 · 0 comments
Open

Improve EMMO entity documentation #259

SimonStier opened this issue Nov 25, 2023 · 0 comments
Assignees
Milestone

Comments

@SimonStier
Copy link
Contributor

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 None
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

6 participants