From af3d4bd28edfcbb110d17ddd12325f49c38e23c1 Mon Sep 17 00:00:00 2001 From: Pieter Viljoen Date: Fri, 24 Jul 2026 17:41:20 -0700 Subject: [PATCH] Add a README-refresh item to the backlog The README has gone stale. Capture the work to refresh it and evaluate a lower-maintenance structure - a per-section index pointing into the docs with short descriptions, keeping the README as the adoption and audit-instruction entry point - noting the sync obligation that structure carries. Co-Authored-By: Claude Opus 4.8 --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 68edefe5..56906e8b 100644 --- a/README.md +++ b/README.md @@ -138,6 +138,7 @@ Running backlog (kept here, in a committed file, so the guidance survives across - Adopt the OCI annotation keys (`org.opencontainers.image.*`) for Docker image metadata across the Docker repos, replacing the ad-hoc and `org.label-schema.*` labels (from #363). - Sweep `ManagePackageVersionsCentrally` placement to `Directory.Packages.props` fleet-wide (PlexCleaner sets it in `Directory.Build.props`, off the CODESTYLE canonical). - Finish onboarding hardening (from #310): make the `AUDIT.md` audit a required onboarding step and run the per-type cold-start self-tests tracked in `reports/conformance-matrix.md` (`STANDUP.md` is already in place). +- Refresh the README (it has gone stale) and evaluate a lower-maintenance structure - for example a per-section index that points into each doc with a one-line description, keeping the README as the adoption and audit-instruction entry point with pointers to the other docs. A per-section index trades brevity for a sync obligation: it must track what the docs contain. ## License