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).
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).
- Zorg dat de repo voldoet aan het docs-contract
(
docs/org/conventies.md): root-/docsmetindex.md, front-matter, CODEOWNERS. - Voeg één entry toe aan de
repos-lijst inmkdocs.yml(PR).
.forgejo/workflows/docs.yml: bij push naar main → uv sync --frozen →
mkdocs build --strict → force-push van site/ naar de pages-branch.
Draait als container-job op de eigen runners (label con-ci-oci, zie de
talos-sectie van het handboek).