Read the Docs

Published documentation: ontologos.readthedocs.io

The site is built with MkDocs Material from the docs/ directory. Configuration lives at the repository root:

File	Purpose
.readthedocs.yaml	Read the Docs build config (MkDocs + Python 3.11)
mkdocs.yml	Site navigation, theme, plugins
docs/requirements.txt	Python packages installed on RTD

Import the project on Read the Docs (maintainers)

1. Sign in at readthedocs.org with GitHub.
2. Import a Project → select eddiethedean/ontologos.
3. RTD detects .readthedocs.yaml automatically.
4. Set the default branch to main and enable Build pull requests (optional).
5. After the first build, the site is live at https://ontologos.readthedocs.io/.

No secrets are required for a standard public MkDocs build.

Build locally

python3 -m venv .venv-docs
source .venv-docs/bin/activate
pip install -r docs/requirements.txt
mkdocs serve

Open http://127.0.0.1:8000/ for live reload.

Static output:

NO_MKDOCS_2_WARNING=1 mkdocs build --strict

Output directory: site/ (gitignored).

Adding pages

1. Add or edit Markdown under docs/.
2. Register the page in mkdocs.yml nav (required for discoverability).
3. Prefer links relative to docs/ (e.g. guides/python.md), not ../ paths to the repository root.
4. Root-level files (README.md, ROADMAP.md, …) are included via wrappers or linked from Roadmap summary — edit the source file at the repo root when updating release plans.

CI

GitHub Actions runs NO_MKDOCS_2_WARNING=1 mkdocs build --strict on every push/PR to validate the docs site builds cleanly.