Skip to content

Commit

Permalink
Add contributing guide
Browse files Browse the repository at this point in the history
  • Loading branch information
ChristophB committed Nov 26, 2024
1 parent fdf2883 commit f147f55
Show file tree
Hide file tree
Showing 2 changed files with 43 additions and 0 deletions.
40 changes: 40 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Contributing Guide

Thank you for investing your time in contributing to our project!

Read our [Code of Conduct](CODE_OF_CONDUCT.md) to keep our community approachable and respectable.

## Issues and Support

If you find a problem or have a question about the content in this repository and how to use it,
please create an issue in the [Issues Tracker](https://github.com/Onto-Med/GFO/issues).
Make sure you describe the problem as clearly as possible.

## Workflow to Make Contributions

We are very happy about contributions!

It is recommended to use an ontology editor such as [Protégé](https://protege.stanford.edu/).
If you want to contribute changes, please do so by:

1. Clone this repository ([fork](https://github.com/Onto-Med/GFO/fork) for external contributors).
2. Creating a new feature branch.
3. Apply your changes.

Edit the ontology files using a suitable ontology editor or text editor.
Adhere to the GFO's existing coding style and conventions.
Ensure your changes are well-documented and understandable.
You can run the following command with docker to check your changes locally (in this case `modules/gfo-base.owl` is checked):

docker run -it -v .:/gfo -w /gfo obolibrary/odklite robot report --input modules/gfo-base.owl --profile qc_report/profile.txt

4. Commit and push all changes.
5. Create a [pull request](https://github.com/Onto-Med/GFO/pulls).

On GitHub, create a pull request from your branch to the main branch of the official GFO repository.
Provide a clear description of your changes and the rationale behind them.

6. Review and Feedback.

Be prepared to address feedback and suggestions from the GFO community and maintainers.
Work collaboratively with other contributors to refine your changes.
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ The entire GFO ontology can be imported via IRI https://w3id.org/gfo. GFO is div

**GFO-light** is a simplified view of the entire GFO. It does not build on single modules but combines all basic concepts and simplified axioms of the GFO. It is primarily intended to found domain or application ontologies and can be imported via IRI https://w3id.org/gfo/light.

## How to Contribute
Please see our [Contributing Guide](CONTRIBUTING.md).

## Brief History
Work on GFO has started in 1999 in the context of the GOL project (General Ontological Language). Meanwhile, several directions of research have been recognized and divided the initial project, such that GFO is now one component of a larger framework. Work on GFO remains in progress, because the development of top-level ontologies is a long-term research effort.

Expand Down

0 comments on commit f147f55

Please sign in to comment.