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

Avoid (Ontological) Weasel Words in Definitions (unnecessary phrases or clauses that merely suggest a boundary) #218

Open
jonathanvajda opened this issue Feb 15, 2024 · 1 comment

Comments

@jonathanvajda
Copy link

I had conversation with the CUBRC team offline, but I was told to make this request public.

Definitions should avoid examples and intentionally vague language. This isn't an inviolable rule, but one we can avoid in a mid-level ontology. There are cagey words that give wiggle room, and we can avoid them. Terms and phrases like:

  • example
  • such as
  • in other words
  • for illustration
  • for instance
  • typical*
  • usual*
  • mostly
  • often

Examples are supposed to be annotated with cco:example_of_usage
Elucidations are supposed to be annotated with cco:elucidation

For the mid-level ontologies, here's what my QC SPARQL query pulled:

@jonathanvajda jonathanvajda changed the title Avoid (Ontological) Weasel Words in Definitions (unnecessary phrases clauses that merely suggest a boundary) Avoid (Ontological) Weasel Words in Definitions (unnecessary phrases or clauses that merely suggest a boundary) Feb 15, 2024
@swartik
Copy link

swartik commented Feb 16, 2024

@jonathanvajda I hope future versions of CCO incorporate your points. They should be in the Best Practices of Ontology Development document.

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

2 participants