👍 First of all: Thank you for taking the time to contribute!
The following is a set of guidelines for contributing to T4FS. These guidelines are not strict rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
- Code of Conduct
- Guidelines for Contributions and Requests
- Reporting problems with the ontology
- Requesting new terms
- Suggesting Enhancements
- [Fixing problems with the ontology by yourself](#fixing problems)
- Adding new terms by yourself
- Best practices
The terms4FAIRskills (T4FS) team strives to create a welcoming environment for editors, users and other contributors. Please carefully read our Code of Conduct.
Please use our Issue Tracker for reporting problems with the ontology. To learn how to write a good issue see here.
Before you write a new request, please consider the following:
- Does the term already exist? Before submitting suggestions for new ontology terms, check whether the term exist, either as a primary term or a synonym term. You can search for your term using OLS.
- Can you provide a definition for the term? It should be very clear what the term means, and you should be able to provide a concise definition, ideally with a scientific reference.
- Is the ontology in scope for the term? Sometimes, it is hard to tell whether a term "belongs" in and ontology. A rule of thumb is "if a similar term already exists, the new term is probably in scope." It can be very helpful to mention a very similar concept as part of the term request!
Anyone can request new terms. However, there is not guarantee that your term will be added automatically. Since this is a community resource, it is often necessary to do at least some of the work of adding the term yourself, see below.
Request a new term via the GitHub Issue Tracker.
It is important to remember that it takes a lot of time for curators to process issues submitted to the tracker. To make this work easier, please always use issue templates if they are available (https://github.com/terms4FAIRskills/FAIRterminology/issues/new/choose).
For how to write a good term request, please read the best practices carefully.
If you have never edited this ontology before, first follow a general tutorial
Process:
- Clone the repository (In case you are not an offical team member, create a fork first)
- Create new branch in git, for example
git checkout -b issue123 - Edits to classes/properties the ontology are performed in Google spreadsheets, which are then downloaded and committed to this repository within src/templates. Please see Templates README for details of how to make these changes.
- Edits to the top-level annotation (e.g. title, description, authors) happen within
src/ontology/t4fs-edit.owl. Open this file in your favourite editor, i.e. Protege. Careful: double check you are editing the correct file. There are many ontology files in this repository, but only one editors file! - Perform your edits and save your changes
- Commit changes to branch
- Push changes upstream
- Create pull request
Find out more about our deprecation policy.
If you are part of the team that builds releases, please see our editors' release documentation.
Please refer to the OBO Academy best practices.
Please refer to the OBO Academy best practices