T-9LHH-site-roadmap-generated
Status: closed/done · Impact: medium · Complexity: medium
Retire the last entity-shaped hand-written page: /roadmap/
generates from milestone entities — static direction narrative plus
Active/Emerging tables and shipped history.
D-0010-deterministic-site-assembly §5, Migration Phase 7.
| Location | Role today |
|---|---|
site/src/content/docs/roadmap.md | Hand-written; narrates milestones that exist as entities; drifts |
plugin/lib/services/docs/site/nav.ts | generated: roadmap slot reserved, not yet expanded |
Proposed
Section titled “Proposed”roadmap.eta renders: a static narrative preamble owned by the
generator (data-model-page precedent — current direction prose
ported verbatim where still true), Active/Emerging milestone tables
(Id / Title / Version / Target date / Summary inlined), and a shipped
history from closed/* milestones with completion notes. The
hand-written roadmap.md is deleted; the roadmap nav slot expands
to a single entry at its site.yaml position.
Approach
Section titled “Approach”roadmap.eta+ builder reusing the milestone projection’s data (Version/Target-date columns from T-I6WC-site-corpus-curated-types’s override).- Port the current page’s still-true narrative into the static preamble; verify content parity for everything the tables carry.
- Delete
site/src/content/docs/roadmap.mdfrom hand-written status (it becomes generated output at the same route). - Expand the
roadmapnav slot. - Tests: roadmap assembly fixtures, empty-bucket tolerance, idempotency.
Files to touch
Section titled “Files to touch”| Location | Kind | Change |
|---|---|---|
plugin/lib/services/docs/roadmap.eta | new | Page family |
plugin/lib/services/docs/site/projections.ts | modify | Roadmap builder |
plugin/lib/services/docs/site/nav.ts | modify | roadmap slot |
site/src/content/docs/roadmap.md | modify | Becomes generated output |
site/site.yaml | modify | generated: roadmap slot |
plugin/lib/services/docs/tests/ | modify | Roadmap suites |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1:
/roadmap/carries the AUTO-GENERATED banner; milestone rows derive from the live corpus (a new milestone appears on regeneration). - AC-2: Closed milestones render in shipped history with completion notes.
- AC-3: Route unchanged; site build green.
Out of scope
Section titled “Out of scope”- Changelog generation — changelog stays supplemental (release narrative encodes judgment).
Dependencies
Section titled “Dependencies”- T-I6WC-site-corpus-curated-types — milestone projection override.
Discovery context
Section titled “Discovery context”Extracted from D-0010-deterministic-site-assembly Migration Phase 7.
Depends on
Section titled “Depends on”T-I6WC-site-corpus-curated-types