De docs-pipeline is rood — wat nu

Er is maximaal één open issue met label docs-drift in Conduction/handbook; die verwijst naar de gefaalde run. Werk de oorzaak weg in de bronrepo (nooit in handbook, tenzij het een org-pagina is) en de issue sluit vanzelf bij de volgende groene geplande run.

Per gate

Freshness-gate ("last_reviewed … dagen oud"): de pagina is over de houdbaarheid (365 dagen) of mist front-matter. → Review de pagina inhoudelijk in de bronrepo en zet last_reviewed op vandaag — de review zelf ís de handeling, ook zonder tekstwijziging. Owner staat in de front-matter van de pagina. Let op: warn-only tot 2026-08-07; daarna blokkeert dit de build.
Linkcheck (lychee) ("404 …"): dode externe link. → Fix of verwijder de link in de bronrepo. 403/429 tellen niet als dood (bot-blocking, rate limits, en onze egress-proxy — dekking is dus partieel; zie het commentaar in lychee.toml).
Build/clone-fouten (--strict-fouten, TLS-fouten): → strict-fouten zijn kapotte interne links of nav-problemen in een bronrepo; TLS/clone-fouten zijn meestal eenmalig (retry zit al in de pipeline) — run opnieuw via workflow_dispatch. Blijft het: check de egress-allowlist van con-ci-oci (repo talos) en de docs-contract-status van de bronrepo.

Gate-configuratie

Maximumleeftijd en warn-only: stap "Freshness-gate" in .forgejo/workflows/docs.yml
Linkcheck-gedrag: lychee.toml
Wekelijkse run: cron in dezelfde workflow (maandag 06:00)

Herhaalbaar bewijs (ISO 27001)

Elke run-log toont het aantal gecontroleerde pagina's, de bevindingen en de gehanteerde maximumleeftijd — dat is het bewijs dat documentatie actueel wordt gehouden. Bewaar niets handmatig; de run-historie is het archief.