docs(nav): publish every ADR and runbook, gated by a nav check (closes #169) #172

Merged
not merged 3 commits from docs/169-mkdocs-nav into main 2026-09-18 12:55:21 +00:00
3 Commits
Author SHA1 Message Date
not ab4392320a docs(nav): point the landing page at the Kubernetes runbook (refs #169)
CI / build (pull_request) Successful in 4m45s
CI / lint (pull_request) Successful in 5m4s
CI / unit (pull_request) Successful in 1m0s
CI / frontend (pull_request) Successful in 1m56s
CI / mutation (pull_request) Successful in 3m10s
CI / verify-stack (pull_request) Successful in 6m8s
2026-09-10 11:04:08 +02:00
not 16509a399c docs(nav): publish every ADR and runbook, not just the first ten (refs #169)
ADR-0011 through ADR-0034, six of the seven runbooks (OpenZaak, Open Notificaties,
Keycloak, Flowable, Kubernetes-on-Talos, Gitea Actions gotchas) and synthetic-data.md
are now in mkdocs.yml's nav, which makes `make lint` green again.

Also fills in ADR-0033's `Slice:` header, which said "none yet" — #25 closed it.
2026-09-10 11:03:39 +02:00
not 8df3faf979 test(docs): fail when a page under docs/ is missing from the nav (refs #169)
Only the pages listed in mkdocs.yml's nav are published, and mkdocs' own
`omitted_files: warn` keeps the build green while dropping the rest — so nothing
ever said that the site had quietly stopped at ADR-0010 and runbooks/ci.md.

Runs in `make lint` (python3 only, no new tooling), so it gates every PR through
the existing job.

Red: 31 pages are missing — ADR-0011 through ADR-0034, six of the seven runbooks,
and synthetic-data.md.
2026-09-10 11:02:52 +02:00