OBI is a community effort, and we greatly appreciate submissions of new terms! Here are some tips to help you get started.
If you find a term that’s close enough, but would like additions or changes made to it, please submit a new ticket to our issue tracker and be sure to include:
When you are ready, follow this link to create a new ticket (a GitHub account is required):
If you don’t find the term you’re looking for, but it’s within OBI’s scope of biomedical investigations, please suggest that we add it to OBI as a new term. We’ll need the following information before we can add your term (more details below):
When you’ve collected as much of this information as possible, please follow this link to submit a term request to our tracker (a GitHub account is required):
For large sets of new terms, we suggest using our term templates to standardize your requests. These exist in a spreadsheet format to allow for consistancy across a large number of new terms. Currently, there are termplates for assay, device, study design, and more. Templates can be found here https://github.com/obi-ontology/obi/tree/master/src/ontology/templates
If you require a new template for your project, please contact us for assistance.
The ‘editor preferred term’ is an unambiguous label that uniquely identifies the term within the OBO Foundry. There must be one and only one editor preferred term, and it must be in American English. It should not contain any acronyms or jargon words, and it should make sense when read outside the context of a scientific investigation. As you might expect, all these requirements combine to make many of OBI’s editor preferred terms long and ugly. But the most important thing is that they’re clear! (See also the OBO Foundry naming conventions.)
There can be many ‘alternative term’ annotations for a given term in OBI. They can include acronyms and jargon – in fact, if the editor preferred term spells out an acronym then it’s a good idea to put the abbreviated form in an alternative term annotation. They can be in any language, but make sure to specify which language if it is not American English so we can note that. Alternative term annotations do not have to be unique across OBI or the OBO Foundry.
The ‘textual definition’ is the most important annotation because it expresses the meaning of your term. Definitions should have Aristotelian form: “An A is a B that C” where A is your new term, B is the parent term, and C spells out how A is a special kind of B. Every term needs one and only one textual definition, in American English, and definitions must be unique across the OBO Foundry. (See also the OBO Foundry Principle on textual definitions.)
Every textual definition should have a ‘definition source’. If you created the definition, then that source would be you, and we’ll record your name. If the definition was adapted from Wikipedia or some other website, then this annotation should contain the permanent URL. If it was adapted from a paper, use its DOI or PubMed URL.
The logical definition of a term is almost as important as the textual definition. We say “almost” because, in case of misunderstandings, the textual definition takes precedence. The logical definition expresses the meaning of the term in a machine-readable way using the Web Ontology Language (OWL) version 2. Most OBI terms are OWL Classes (i.e. general nouns) and every one of these requires a single parent class. Many of them have more complex logical definitions. If you aren’t comfortable specifying a logical definition, that’s fine. OBI developers are happy to help create one based on your textual definition.
One or more ‘example of usage’ annotations can really clarify the meaning of a term. While the textual definition must be general enough to cover all cases, the examples provide specific cases that show the term in action. Examples of usage can be common cases that demonstrate the prototypical usage, or uncommon edge cases that delimit the scope of the term. While not strictly required, every new term should have one or more examples of usage.
Finally, we want to give you credit for your work. We will add one or more ‘term editor’ annotations with your name, and the names of others who have collaborated on creating this term for OBI.