Skip to content

F9.2 — Build documentation strictly in CI

State Closed
Parent E9
Iteration Release 1
Closed Date 2026-09-27
Predecessors the root and seven package sites building cleanly with --strict, which they do today

Stories: 1 Closed

Story State Depends on
S9.2.1 — Make the docs job strict Closed (2026-09-27) —

The CI docs job runs uv run --group docs mkdocs build without --strict, so a broken link or anchor passes CI. Locally, every site builds strictly.

S9.2.1 — Make the docs job strict

State: Closed (2026-09-27)

Acceptance: the CI docs job runs MkDocs with --strict, and a pull request shows it passing.

The flag is set and the combined site builds strictly locally. The docs job runs only on a push to main; the first merge run (f3d1757) confirmed it.

set -euo pipefail
grep -q 'mkdocs build --strict' .github/workflows/main.yml