Doc Freshness - when to update the authored docs

A repository document, rendered for the site. View source markdown.

Generated at: 2026-07-30T12:38:02.000Z UTC · source: committed helm-expt evidence for this rendered repository document.

The corpus's generated docs cannot go stale silently: their verifiers fail the build. The authored docs (README, docs/) CAN - they describe evidence that keeps moving. This snapshot answers "which authored doc needs review right now": a doc is review-due when an evidence source it links to (under data, scripts, tests, recipes, packages, CATALOG.md) changed more recently than the doc itself.

Colored rendering: freshness.html (open in a browser). Snapshot as of 2026-07-29 (commit bc4c9671b). Refresh with npm run doc-freshness - cheap, ride it on any docs PR. The verifier gates completeness (every authored doc is in the snapshot) without breaking the build as history moves.

Two ways to clear a review-due row, both legitimate: edit the doc (its last-changed date advances), or acknowledge it in reviewed.csv with a doc,reviewed_on,note row saying it was reviewed and is still accurate. Acknowledgments exist so docs that link fast-churning dashboards do not sit permanently red until someone makes a cosmetic edit.

Current Status

MetricCount
Authored docs tracked234
Fresh (no linked source newer than the doc)22
Review-due71
No linked evidence sources (cannot auto-trigger)141

Review queue

Sorted by how far behind the doc is. "Newer sources" shows up to the three most recently changed triggers.

DocAreaDoc last changedDays behindNewer sources
docs/user/helm-pain-points.mduser2026-06-1049data/outcome-coverage/base-outcomes.csv (2026-07-29)<br>data/variant-path-coverage/coverage-matrix.csv (2026-07-29)<br>data/pain-point-coverage/pain-points.csv (2026-06-10)
docs/user/top100-readiness.mduser2026-06-1049data/outcome-coverage/base-outcomes.csv (2026-07-29)<br>data/top100-readiness/next80-queues.csv (2026-07-29)<br>data/top100-readiness/next80-queues.md (2026-07-29)
docs/user/why-this-does-not-collapse.mduser2026-06-1049data/top100-coverage/summary.md (2026-07-29)<br>data/live-e2e/normalization-rules.md (2026-06-30)<br>data/quirk-coverage/summary.md (2026-06-24)
docs/planning/large-machine-handover.mdplanning2026-06-1148data/outcome-coverage/summary.md (2026-07-29)
docs/reference/helm-quirk-support-matrix.mdreference2026-06-1148data/top100-user-readiness/summary.md (2026-07-29)
docs/reference/proof-kit-migration.mdreference2026-06-1148data/live-helm-confighub-compare/summary.md (2026-07-29)
docs/reference/top100-user-readiness.mdreference2026-06-1248data/outcome-coverage/base-outcomes.csv (2026-07-29)<br>data/top100-readiness/readiness.csv (2026-07-29)<br>data/top100-readiness/summary.md (2026-07-29)
docs/reference/what-hook-support-means.mdreference2026-06-1148data/hook-disposition/top100-hook-dispositions.csv (2026-07-29)
docs/user/extension-slots.mduser2026-06-1148data/extension-slots/extension-slots.csv (2026-07-29)<br>data/extension-slots/summary.md (2026-06-30)
docs/user/outcomes-and-tests.mduser2026-06-1148CATALOG.md (2026-07-29)<br>data/README.md (2026-07-29)<br>data/edge-recovery/edges.csv (2026-07-29)
docs/user/verification-lanes.mduser2026-06-1148data/outcome-coverage/summary.md (2026-07-29)<br>tests/npm-scripts.md (2026-07-28)
docs/user/production-support-decisions.mduser2026-06-1147data/production-disposition/summary.md (2026-07-28)<br>data/production-support-decisions/decisions.csv (2026-07-28)<br>data/production-support-decisions/summary.md (2026-07-28)
docs/user/serious-charts.mduser2026-06-1147data/hard-chart-production-packets/summary.md (2026-07-28)<br>data/production-readiness-packets/cert-manager/packet.md (2026-06-23)<br>data/production-readiness-packets/external-secrets/packet.md (2026-06-23)
docs/user/top100-status.mduser2026-06-1247data/top100-readiness/summary.md (2026-07-29)<br>data/top100-user-readiness/summary.md (2026-07-29)<br>data/top20-base-readiness/start-here.md (2026-07-28)
docs/planning/helm-community-persona-plan.mdplanning2026-06-1346data/live-helm-confighub-compare/summary.md (2026-07-29)<br>data/live-kind-parity/summary.md (2026-07-29)<br>data/live-parity-rerun-plan/summary.md (2026-07-29)
docs/planning/where-does-my-hook-go.mdplanning2026-06-1446data/lifecycle-routes/routes.json (2026-07-29)<br>data/lifecycle-routes/summary.md (2026-07-29)
docs/reference/secret-lifecycle.mdreference2026-06-1346data/secret-lifecycle/secrets.csv (2026-07-29)<br>data/secret-lifecycle/summary.md (2026-07-29)<br>data/secret-lifecycle/variant-summary.csv (2026-07-29)
docs/reference/variant-promotion-model.mdreference2026-06-1445data/variant-promotion/summary.md (2026-07-29)
docs/reference/matrix-completion-audit.mdreference2026-06-1644data/master-catalog-matrix/summary.md (2026-07-29)<br>data/disposition-frontier/summary.md (2026-07-29)<br>data/live-matrix-burndown/summary.md (2026-07-29)
docs/reference/residue-families.mdreference2026-06-1644data/lifecycle-route-actions/summary.md (2026-07-29)<br>data/live-parity-decisions/summary.md (2026-07-29)<br>data/live-parity-rerun-plan/summary.md (2026-07-29)
docs/planning/next-20-tasks.mdplanning2026-06-1643data/outcome-coverage/summary.md (2026-07-29)<br>data/claims-register/summary.md (2026-07-27)<br>data/variant-goldens/derived-expansion-wave/README.md (2026-06-30)
docs/user/target-prerequisites-before-rerun.mduser2026-06-1643data/model-gap-workdown/summary.md (2026-07-29)<br>data/target-prerequisite-actions/summary.md (2026-07-29)<br>data/target-prerequisite-workdown/summary.md (2026-07-29)
docs/reference/master-catalog-matrix.mdreference2026-06-1842data/master-catalog-matrix/matrix.csv (2026-07-29)<br>data/master-catalog-matrix/matrix.html (2026-07-29)<br>data/master-catalog-matrix/summary.md (2026-07-29)
docs/user/reading-the-matrix.mduser2026-06-1842data/lifecycle-route-actions/summary.md (2026-07-29)<br>data/master-catalog-matrix/matrix.html (2026-07-29)<br>data/live-matrix-burndown/summary.md (2026-07-29)
docs/reference/variant-promotion-closeout.mdreference2026-06-1841data/variant-promotion-closeout/summary.md (2026-07-29)<br>data/variant-promotion/status.csv (2026-07-29)
docs/user/generative-gitops-fit.mduser2026-06-1841data/master-catalog-matrix/matrix.html (2026-07-29)<br>data/outcome-evidence-contract/summary.md (2026-07-29)<br>data/claims-register/summary.md (2026-07-27)
docs/planning/robust-sceptic-plan.mdplanning2026-06-1839data/claims-register/summary.md (2026-07-27)
docs/planning/outside-user-test.mdplanning2026-06-2138data/top100-coverage/summary.md (2026-07-29)<br>tests/README.md (2026-07-28)
docs/planning/user-journey-test-pathways-plan.mdplanning2026-06-2138tests/README.md (2026-07-28)
docs/user/pathway-route-hooks-transparently.mduser2026-06-2138tests/README.md (2026-07-28)
docs/planning/current-handover.mdplanning2026-06-2337CATALOG.md (2026-07-29)<br>data/live-parity-rerun-plan/summary.md (2026-07-29)<br>data/outcome-coverage/summary.md (2026-07-29)
docs/planning/next-execution-plan.mdplanning2026-06-2337data/status-dashboard/summary.md (2026-07-29)<br>data/live-parity-rerun-plan/summary.md (2026-07-29)<br>data/outcome-coverage/summary.md (2026-07-29)
docs/user/what-you-get.mduser2026-06-2931data/edge-recovery/summary.md (2026-07-29)
docs/user/verification.mduser2026-06-3030data/status-dashboard/summary.md (2026-07-29)<br>data/outcome-coverage/summary.md (2026-07-29)<br>tests/npm-scripts.md (2026-07-28)
docs/user/prometheus-high-fanout.mduser2026-06-3029recipes/prometheus-community/kube-prometheus-stack/85.3.3/CATALOG.md (2026-07-29)
docs/user/verify-it-yourself.mduser2026-06-3029data/live-kind-parity/summary.md (2026-07-29)
docs/user/variants-after-upload.mduser2026-07-0327data/master-catalog-matrix/summary.md (2026-07-29)
docs/planning/pilot-adversarial-testing.mdplanning2026-07-0524tests/README.md (2026-07-28)
docs/planning/dedicated-website-plan.mdplanning2026-06-2223tests/persona-ux-strategy.md (2026-07-14)
docs/planning/persona-ux-rerun-2026-06-22.mdplanning2026-06-2223tests/persona-ux-strategy.md (2026-07-14)
docs/user/helm-presets-and-values.mduser2026-07-0722data/confighub-example-guides/summary.md (2026-07-29)
docs/planning/chart-claim-integrity-audit-2026-06-22.mdplanning2026-06-2321tests/persona-ux-strategy.md (2026-07-14)<br>data/chart-claim-integrity-audit-2026-06-22/summary.md (2026-07-02)
docs/user/target-prerequisites.mduser2026-07-0920data/master-catalog-matrix/summary.md (2026-07-29)<br>data/live-kind-parity/summary.md (2026-07-29)<br>packages/jetstack/cert-manager/v1.20.2/installer.yaml (2026-07-28)
docs/reference/quirk-coverage.mdreference2026-06-1119data/extension-slots/summary.md (2026-06-30)<br>data/quirk-coverage/coverage.csv (2026-06-24)<br>data/quirk-coverage/summary.md (2026-06-24)
docs/user/nginx-configuration-files.mduser2026-06-1119data/extension-slots/summary.md (2026-06-30)
docs/user/remote-images-and-supported-bases.mduser2026-06-1613data/image-digest-workdown/summary.md (2026-06-29)<br>data/remote-image-runtime-workdown/summary.md (2026-06-24)
docs/planning/free-path-pitch.mdplanning2026-07-1412data/cub-adoption-caveats/summary.md (2026-07-25)
docs/user/known-gaps-we-surface.mduser2026-06-2112data/crd-ordering-gap/summary.md (2026-07-03)<br>data/default-credential-check/summary.md (2026-07-01)
docs/user/how-it-works.mduser2026-07-236tests/README.md (2026-07-28)<br>tests/doctrine.md (2026-07-26)<br>data/oci-hook-delivery-proof/summary.md (2026-07-26)
docs/user/helm-upgrade-crash-example.mduser2026-06-135data/blast-radius-accuracy/summary.md (2026-06-18)
docs/planning/agreed-execution-plan.mdplanning2026-07-263data/status-dashboard/summary.md (2026-07-29)<br>data/live-parity-rerun-plan/summary.md (2026-07-29)<br>data/outcome-coverage/summary.md (2026-07-29)
docs/user/chart-hooks-what-happens.mduser2026-07-273data/kps-lifecycle-route-proof/summary.md (2026-07-29)<br>data/lifecycle-route-actions/summary.md (2026-07-29)<br>data/lifecycle-routes/summary.md (2026-07-29)
docs/user/current-proof-status.mduser2026-07-273CATALOG.md (2026-07-29)<br>data/kps-lifecycle-route-proof/summary.md (2026-07-29)<br>data/master-catalog-matrix/matrix.html (2026-07-29)
docs/user/hard-questions.mduser2026-07-263data/secret-lifecycle/summary.md (2026-07-29)<br>data/claims-register/summary.md (2026-07-27)
docs/user/hook-lifecycle-strategy.mduser2026-07-273data/kps-lifecycle-route-proof/summary.md (2026-07-29)<br>data/lifecycle-routes/routes.csv (2026-07-29)<br>data/lifecycle-routes/routes.json (2026-07-29)
docs/user/security-end-to-end.mduser2026-07-263tests/README.md (2026-07-28)<br>tests/doctrine.md (2026-07-26)
docs/user/serious-chart-proof.mduser2026-07-263recipes/prometheus-community/kube-prometheus-stack/85.3.3/CATALOG.md (2026-07-29)
README.mdroot2026-07-282CATALOG.md (2026-07-29)<br>data/status-dashboard/summary.md (2026-07-29)<br>data/live-helm-confighub-compare/summary.md (2026-07-29)
docs/planning/config-catalog-demo-program.mdplanning2026-07-272data/serverless-oci-gitops-proof/summary.md (2026-07-28)
docs/planning/roadmap.mdplanning2026-07-272data/master-catalog-matrix/matrix.html (2026-07-29)<br>data/top50-completion/summary.md (2026-07-29)<br>data/lifecycle-boundary/summary.md (2026-07-29)
docs/user/config-catalog-demonstrations.mduser2026-07-282data/helm-render-intents/summary.md (2026-07-29)<br>data/hook-lifecycle/receipts/prometheus-community-kube-prometheus-stack/default/latest.yaml (2026-07-29)<br>data/kps-lifecycle-route-proof/summary.md (2026-07-29)
docs/user/installer-oci-packages.mduser2026-07-282data/installer-oci-packages/packages.csv (2026-07-29)<br>data/installer-oci-packages/packages.json (2026-07-29)
docs/planning/upgrade-story-plan.mdplanning2026-06-101data/refresh-survival/kube-prometheus-stack-upgrade-seed.md (2026-06-10)
docs/reference/config-catalog-doctrine.mdreference2026-07-281data/oci-deploy-stage-rollout-proof/summary.md (2026-07-29)
docs/user/README.mduser2026-07-261data/app-readiness/summary.md (2026-07-27)
docs/user/ai-assisted-helm-changes.mduser2026-07-271data/ai-change-review-live-proof/summary.md (2026-07-27)
docs/user/choosing-commands.mduser2026-07-281tests/npm-scripts.md (2026-07-28)
docs/user/gitops-adopter-guide.mduser2026-07-261tests/doctrine.md (2026-07-26)
docs/user/helm-render-intents.mduser2026-07-281data/helm-render-intents/contract-gaps.csv (2026-07-29)<br>data/helm-render-intents/contract-gaps.md (2026-07-29)<br>data/helm-render-intents/intents.csv (2026-07-29)
docs/user/live-parity.mduser2026-07-291data/live-helm-confighub-compare/summary.md (2026-07-29)<br>data/live-kind-parity/summary.md (2026-07-29)<br>data/live-matrix-burndown/summary.md (2026-07-29)
docs/user/offering.mduser2026-06-301data/chart-use-guide/summary.md (2026-07-01)

Docs with no linked evidence sources

These cannot be auto-triggered by source changes. Either they are timeless, or they should link the evidence they describe - linking is what wires a doc into this freshness model.

Regenerate

npm run doc-freshness
npm run doc-freshness:verify