Skip to content

0071 — Four-tag version filter: Live, Current, Release, Future

Status

Folded into tags.md (published tag legend + reader vocabulary) and CONTRIBUTING.md (author-facing tagging rules) — both already cite this ADR as the decision record. Defer to those pages for the current reader-facing description. (re-verified 2026-08-06)

Context

The docs site carried a two-tag phase vocabulary (Launch / Current) that strained as the docset grew: the shipped surface split into gameplay-verified vs. code-verified-only, the roadmap surface split into firm 1.0 commitments vs. exploratory/post-launch ideas, and individual pages routinely mixed maturity levels with no in-page filter. The decision replaces the two-tag model with a four-tag cumulative maturity ladder (Live, Current, Release, Future), section-level markers for pages that mix lanes, a real-time topbar filter, and a lint-enforced matrix reconciling the tags with the existing inline ✅ 🚧 📐 🐛 status markers.

Folded into:

  • ../tags.md — public tag legend and reader vocabulary.
  • ../CONTRIBUTING.md — author-facing tagging rules, the tag/marker matrix, migration notes.
  • ../tags.md
  • ../CONTRIBUTING.md §Phase tags
  • ../FEATURES/README.md — inline status convention that composes with version tags.
  • ADR-0066 — doc philosophy compliance (prescriptive-voice, no historical narrative) — informs the meta-files-exempt rule.