OBO Foundry membership requirements and technical details
Expectations for OBO Membership
Participation in the OBO Foundry implies willingness to discuss your project and collaboratively develop it. You are strongly encouraged to build upon the existing suite of ontologies available in the OBO library.
We recommend projects be orthogonal to each other (i.e. no domain overlap). For those classes that are common across multiple resources (e.g., the class cell) we recommend importing terms from an already existing ontology. Application ontologies (those developed for specific data integration tasks) should reuse terms from existing OBO Foundry domain ontologies. At a minimum, we expect attribution of existing work, specifically through the use of PURLs for individual terms and ontologies.
OBO projects are open and use version control, and so we recommend that you set up an ontology repository on GitHub (or another public version control system). We provide the Ontology Development Kit to help with common ontology development tasks, including the creation of a GitHub repository and appropriate metadata files (see below).
Before you participate in our community, please read and agree to follow our Code of Conduct.
Requirements for OBO Membership
- A project should exist, with work started. We will not “pre-book” IDSPACEs and domains for potential future resources.
- A project must be doing original work within the biological ontology community.
- We will not provide an IDSPACE for a project that is issuing new identifier for existing ontologies.
- If there is clear overlap with an existing domain ontology, you must demonstrate a good faith effort to work with that ontology to provide any new terms needed.
- The required IDSPACE must be available. We do not allow two-letter IDSPACEs and strongly discourage three-letter IDSPACEs that contain the letter “O”. For more details, please see the guidelines for allocating IDSPACEs.
- The resource must be publicly available when released. The general expectation is that the ontology source code is available on a public repository such as GitHub.
- There must be a contact person for the resource. The contact person for resources must be subscribed to our main communication channel, the obo-discuss mailing list.
- The requestor and/or contact person should be ready to discuss issues such as whether the ontology is orthogonal, whether there is potential to collaborate with existing efforts.
- It is expected that solicitation of a IDSPACE is done before the IDSPACE is used for identifiers. A common strategy is to develop an ontology, request a IDSPACE, and translate the initial URIs used to the PURLs some time before the initial release. There is no guarantee that you will be granted your IDSPACE, even if you have been using it in your file.
- As of 4th May 2021, every new ontology submission is required to pass the OBO Dashboard quality control, which means that they are not allowed to have any substantial errors (anything “red”). The only exceptions to this requirement are (1)
Users, and (2) results in the
Reportthat pertain to terms from imported (external) ontologies. Your ontology will be set up in a provisional Dashboard as soon as the GitHub submission request is made. OBO foundry will provide support to help you fix any issues your submission might have.
1. Submitting your ontology to request the IDSPACE
- Submit your request on our GitHub tracker. Select
New Issueand then select
New Ontology Request. Fill out the requested information as completely as possible.
- Send an email to obo-discuss with your request to allow community feedback (you may need to apply to join group first.) Be sure to include the link to the issue you created in step 1.
- (Optional): If you would like to join the obo-community Slack, please indicate this in your email.
We expect general discussion to take place on the obo-discuss list, while technical follow-up will take place on the tracker.
Example of such request for ECTO:
After your submission to the GitHub tracker, your ontology will be set up in a provisional Dashboard. As of 4th May 2021, every new ontology submission is required to pass the dashboard quality control, which means that they are not allowed to have any substantial errors (anything “red”). OBO foundry will provide support to help you fix any issues your submission might have.
After the ontology passes Dashboard quality control, allow up to 4 weeks to give members of the community time to provide feedback and for the Operations Committee to review the request. If you don’t hear back from us after 4 weeks, please follow-up via the tracker issue you created. Note, in some cases, this could take longer.
Based on this discussion, the Operations Committee will either approve the IDSPACE request, ask for changes, or decline your request.
Once an IDSPACE is approved, two important files must be created. Since your project will be responsible for maintaining these files, it’s best if someone on your team reads our documentation and creates these files. If this is impossible, please let us know on your tracker issue, and one of our volunteers will try to accommodate you.
An OBO PURL configuration file. The OBO PURL system helps maintain links to your ontology terms and artifacts. See purl.obolibrary.org/ for configuration file formatting and how to add your new file.
If you used the Ontology Development Kit to create your ontology, then the required YAML files will be created and stored under
These two files should be created as GitHub Pull Requests (PRs) in the appropriate repository (OBO Foundry Registry for the OBO registry entry and OBO PURLs for the PURL configuration). Once these PRs for these two files are merged, your ontology is officially registered with OBO and your PURLs are available.
As your ontology project grows and changes, be sure to update the OBO registry entry and PURL configuration for your project using GitHub Pull Requests.
Every OBO project has an IDSPACE: a short alphanumeric code that uniquely identifies it among the other OBO projects, e.g. “MOBO”. The IDSPACE is an important part of the project PURLs (Persistent Uniform Resource Locators), which are used to identify individual ontology terms as well as project artifacts such as OWL files.
In order to ensure that there is no IDSPACE redundancy, i.e. only one project/resource is using the IDSPACE “MOBO”, these are allocated by the OBO Foundry Technical Working Group.
The Technical Working Group reserves the right to make decisions based on their experience and judgement. In addition to uniqueness of IDSPACEs, other criteria are for example that there not be overlaps of usage. This includes awareness that there can be the appearance of overlap between accession numbers used in databases and prefixed URIs. For example, we would probably not create a IDSPACE “ISBN” and would instead make alternative suggestions.