Semantic artefacts are used to annotate data. Concepts are the key elements of the semantic artefacts used by the annotators. Annotators need both a human readable and logical definition to make a decision on using a specific term. Human readable definitions are therefore crucial for the reuse of semantic artefacts. When building a semantic artefact, one the main challenge is to write a structured definition for concepts. There are recommendations providing guidelines for writing human readable definition as OBO Foundry principle 6 and the IOF principle 10.
A set of 11 guidelines have been proposed following up a dedicated series of workshops and a survey on the usage of definition (Seppälä et al., 2017). A recent blog post from C. Mungall describe in more detail how to write simple and concise definitions.
Semantic artefacts are used to annotate data. Concepts are the key elements of the semantic artefacts used by the annotators. Annotators need both a human readable and logical definition to make a decision on using a specific term. Human readable definitions are therefore crucial for the reuse of semantic artefacts. When building a semantic artefact, one the main challenge is to write a structured definition for concepts. There are recommendations providing guidelines for writing human readable definition as OBO Foundry principle 6 and the IOF principle 10.
A set of 11 guidelines have been proposed following up a dedicated series of workshops and a survey on the usage of definition (Seppälä et al., 2017). A recent blog post from C. Mungall describe in more detail how to write simple and concise definitions.