Docs stack decision: Sphinx + MyST

Status

Accepted (2025-12-19)

Context

We need a documentation stack that is easy to maintain, supports Markdown out of the box, keeps configuration minimal, and offers a fast local preview loop.

Decision

Use Sphinx with MyST Markdown and a minimal docs/conf.py configuration.

Consequences

• Docs live under docs/ with Diataxis sections.

• Local preview runs via just docs (sphinx-autobuild).

• Local HTML builds run via just docs-build (sphinx-build).

• If we need theming or search later, we can add a theme or Sphinx extensions.