LOF-P-007: Textual definitions¶
Proposed for adoption
This principle is part of a proposal for adoption, Adopt principles: terms: identifiers, definitions, and names (#56), which is not yet open for decision. Comments are welcome now, from anyone. When it opens, members will be able to approve or object here.
Draft for ratification
Part of the founding draft of the LOF principles.
Summary¶
Every class and relation has a precise, non-circular textual definition.
Purpose¶
In law, the meaning of a term is often the point in dispute. Definitions make the intended meaning checkable by lawyers and domain experts who will never read an axiom.
Recommendations and requirements¶
- Every class and relation in the ontology's namespace has exactly one English definition, recorded with
skos:definitionorIAO:0000115. - Class definitions take genus and differentia form where possible: "An X is a Y that Z", where Y is the asserted parent.
- Definitions do not use the term being defined, and cite a source (statute, case, treatise) with
dcterms:sourcewhere one exists. - Textual and logical definitions agree. Where a class also has a logical definition (an equivalence axiom, or subclass axioms giving necessary conditions), the textual definition states the same conditions in words, and the logical definition formalizes them: the genus is the same class in both, and each condition in one appears in the other. Conditions that OWL cannot express (for example, about time or about what an agent intends) are stated in the textual definition and noted in an
rdfs:commentbeginning "Not expressed in OWL:". The textual definition records the intended meaning; if the two diverge, the axioms are corrected to match it, or the term is redefined as a new term (LOF-P-005).
Implementation¶
Add the definition when the term is created. Protégé's annotation panel supports both properties.
Examples¶
legal role: "A role that inheres in a person or organization in virtue of recognition by a legal institution and that is realized in legally significant processes." (Illustrative only.)
Criteria for review¶
Definitions are present, match the asserted parent, agree with the logical definition where there is one, and are intelligible to a legal expert.
Automated check: SPARQL check missing-definition-violation.
Feedback and discussion¶
Propose changes to this principle by pull request against
docs/principles/lof-p-007-definitions.md, or open a thread in
Discussions.