Contributing¶
Everything on this site is edited through GitHub, so every change has a recorded author, rationale, and review.
Editing a page¶
- Click the pencil icon at the top of any page.
- GitHub opens the Markdown source. Make your edit.
- Describe the change and choose Propose changes. This creates a pull request.
- A coordinator reviews and merges it, and the site rebuilds automatically.
The registry and ontology detail pages are generated: to change them, edit
the ontology's metadata file in ontology/ instead.
Local preview¶
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python scripts/build_registry.py
mkdocs serve
Where things go¶
| Contribution | How |
|---|---|
| Idea or open question | Discussions |
| New ontology | New ontology request SOP |
| Change to a principle or policy | Pull request, plus an announcement in Discussions (see Governance) |
| New term or term fix | The ontology's own tracker (see Term requests) |
| Ontology review | Review SOP |