# Scaffolding: docs repo governance ## Suggested structure - Keep only user-facing docs; versioned under `versions/<release>/` with `latest` symlink. - Top-level `README.md` describing navigation + contribution rules. - `STYLE.md` for voice, formatting, code fences. ## Automation to add - GitHub Action: `docs-lint.yml` (markdownlint, link checker, front-matter validator). - Phage policy: enforce versioned docs, forbid `archive/` folders, ensure landing page exists. - Branch protection: require `docs-lint` + `link-check` statuses. ## Cleanup tasks - Delete archived/AI-dump folders; move any keepers into `versions/vNEXT`. - Add `versions.json` manifest with latest tag pointer. - Add `docs/STRUCTURE.md` and `docs/CONTRIBUTING.md`.
Scaffolding: docs repo governance
Suggested structure
versions/<release>/withlatestsymlink.README.mddescribing navigation + contribution rules.STYLE.mdfor voice, formatting, code fences.Automation to add
docs-lint.yml(markdownlint, link checker, front-matter validator).archive/folders, ensure landing page exists.docs-lint+link-checkstatuses.Cleanup tasks
versions/vNEXT.versions.jsonmanifest with latest tag pointer.docs/STRUCTURE.mdanddocs/CONTRIBUTING.md.