handbook

Dit is de documentatiesite zelf — één doorzoekbare plek die de /docs van deelnemende repos aggregeert (nooit kopieert; elke bronrepo blijft de bron van waarheid). Deze repo bevat alleen de organisatie-pagina's (docs/org/), de MkDocs-configuratie en de importlijst. De regels, audit en tooling erachter wonen in techbook.

Site: https://conduction.codeberg.page/handbook/ (Codeberg Pages, geserveerd vanaf de pages-branch van deze repo).

Lokaal bouwen

uv sync
uv run mkdocs build --strict     # of: uv run mkdocs serve

De multirepo-plugin kloont bij elke build de /docs van de deelnemende repos (zie mkdocs.yml, plugins.multirepo.repos).

Een repo toevoegen aan het handboek

1. Zorg dat de repo voldoet aan het docs-contract (docs/org/conventies.md): root-/docs met index.md, front-matter, CODEOWNERS.
2. Voeg één entry toe aan de repos-lijst in mkdocs.yml (PR).

Pipeline

.github/workflows/docs.yml (GitHub Actions, ubuntu-latest): bij push naar main en op PR's → uv sync --frozen → pytest → mkdocs build --strict → freshness-gate → linkcheck. Wekelijks ook op maandag 06:00 voor drift-detectie.

Actions staat nog uit op deze repo (migratiebesluit: per repo uit tot na test), dus bovenstaande draait nog niet. Aanzetten: gh api -X PUT repos/ConductionNL/handbook/actions/permissions -f enabled=true

Er is bewust geen deploy-stap. De site staat nog op conduction.codeberg.page/handbook/ en is sinds 2026-08-03 bevroren: de oude Forgejo-pipeline pushte site/ naar een pages-branch op Codeberg met het ingebouwde workflow-token, en op GitHub Actions kan dat token daar niet bij. Publiceren zou een Codeberg-PAT als GitHub-secret vergen — een credential over twee forges voor een tijdelijke situatie. De gates draaien wél, dus drift wordt nog gedetecteerd; alleen het publiceren wacht op de verhuizing naar GitHub Pages (lage prioriteit).