Closed mbjones closed 1 month ago
Just gathering some useful resources to draw inspiration from (ENVO has some really well defined protocols for contributors). I see a few different options, though we may want to provide a couple different ways for editors to contribute depending on their level of familiarity (with Protégé, formalized ontology development, etc.) and the number of terms requested.
Option 1: Request that a small number of terms (e.g. one or few terms) be added as an Issue
Option 2: Ask contributors to use GitHub's fork-and-pull approach
This may be appropriate for contributors who already have familiarity with Protege/formal ontology development and who may want to add many terms. Opening a line of communication/discussion via a GitHub issue prior to submitting a PR is likely important. See ENVO's Steps for contributions by non-editors for well-detailed steps.
NOTE: This would also require that we have a detailed description of our design pattern for contributors to follow.
Option 3: Provide a .csv template, which we can ingest into Protégé
@samanthacsik These all sound like good ideas. For all three options, I think it would be good to have an open issue to discuss and refine terminology proposals. We have an issue template for object format additions to the DataONE formats vocabulary that might be useful as a guide. Here's an example for the GeoJSON format proposal: https://github.com/DataONEorg/object-formats/issues/16
I started a CONTRIBUTING.md file describing how to contribute to the ontology work in issue #89 -- please continue discussion there, and bring any of the ideas along from this thread that are needed. I will leave this open until we've had a chance to migrate ideas, but this should be closed along with #89 when ready.
Completed with #89 , so closing this issue. If further changes/additions to CONTRIBUTING guidelines are needed, please open a new issue.
We need a model for how people can contribute new terms to the salmon ontology, and how we review and vet those for inclusion in a new release of the ontology. This could be as simple as a CONTRIBUTING.md file modeled on our existing ones from other repositories.