Contributing to docs¶

Documentation is published at https://btu.datahenge.com/ from this repository.

Local build¶

pip install -e ".[docs]"
mkdocs serve   # http://127.0.0.1:8000
mkdocs build   # outputs site/

Source layout¶

User docs: docs/get-started/, concepts/, guides/, recipes/, operations/, reference/, integrations/, troubleshooting/.

Maintainer docs: docs/internals/ (ADRs, technical design).

Nav is defined in mkdocs.yml at repo root.

Scheduler doc changes¶

User-facing scheduler content lives here, not on a separate scheduler docs site. When changing btu_scheduler_py behaviour or config, update matching pages in docs/operations/ and docs/reference/.

PR checklist¶

[ ] mkdocs build succeeds
[ ] New pages added to nav in mkdocs.yml if needed
[ ] Links use relative paths within docs
[ ] Screenshots go in docs/assets/images/

Recipe template¶

Goal — one sentence
Prerequisites
Steps — numbered
Verify
Related links