Skip to content

chore(docs): archive v1-rc1 audit docs to history/#522

Merged
trilamsr merged 1 commit into
mainfrom
chore/v1-rc1-archive
Jun 4, 2026
Merged

chore(docs): archive v1-rc1 audit docs to history/#522
trilamsr merged 1 commit into
mainfrom
chore/v1-rc1-archive

Conversation

@trilamsr

@trilamsr trilamsr commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Archives two historical v1.0-rc1 audit snapshots into docs/history/v1-rc1/
so they stop crowding the top-level docs/ listing. v1-rc1-cut-criteria.md
stays in docs/ (load-bearing — see below).

Files moved

  • docs/v1-rc1-governance-gaps.mddocs/history/v1-rc1/governance-gaps.md
  • docs/v1-rc1-operational-gaps.mddocs/history/v1-rc1/operational-gaps.md
  • New: docs/history/v1-rc1/README.md (subdir index, ≤20 lines)

Why cut-criteria.md stayed

scripts/cut_criteria.py:83 pins output path to docs/v1-rc1-cut-criteria.md
(the make cut-criteria-render gate). Three other scripts cite the same path:
scripts/deprecation-check.sh, scripts/attribute-namespace-check.sh,
scripts/rfc-status-check.sh. Moving the file silently breaks the render
parity gate inside make doc-check. The file is generated, not archived —
it stays where the render contract puts it.

Inbound cross-refs updated

  • docs/README.md — replaced single entry with history/v1-rc1/ subdir row
  • docs/MILESTONES.md — operational-gaps reference under M21
  • docs/NORTHSTARS.md — operational-gaps SLSA L3 citation
  • docs/reproducibility.md — operational-gaps SLSA L3 citation
  • docs/migration/v0.x-to-v1.0.md — operational-gaps §2 upgrade-rollback ref
  • docs/2026-Q1-retrospective.md — 6 governance-gaps refs (rubric source)
  • docs/audits/wave-2026-06-01.md — row 9 audit comparison row
  • docs/followups/M3.md — 3 operational-gaps SLSA references

Internal link depth-shift

Both moved files carried ../foo (repo-root) and bare foo.md (docs-root)
relative links. From the new depth docs/history/v1-rc1/, these were
rewritten to ../../../foo and ../../foo.md respectively; sibling refs
between the two archive files stay bare.

docs: archive v1.0-rc1 governance-gaps + operational-gaps audits under docs/history/v1-rc1/; the live cut-criteria rubric stays at docs/v1-rc1-cut-criteria.md (render-gate path-pinned).

Test plan

  • make doc-check green (link gate + cut-criteria render parity + attribute-namespace + RFC-status)
  • pre-push hook clean (lint, vet, deprecation-check, attribute-namespace)
  • grep audit: zero stale v1-rc1-governance-gaps/v1-rc1-operational-gaps refs outside the archive subdir

Signed-off-by: Tri Lam <tree@lumalabs.ai>
@trilamsr trilamsr enabled auto-merge (squash) June 4, 2026 02:27
@trilamsr trilamsr merged commit e35cda4 into main Jun 4, 2026
12 checks passed
@trilamsr trilamsr deleted the chore/v1-rc1-archive branch June 4, 2026 02:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant