Repository navigation
docs: make roadmaps the library landing pages - #145
Alexandre-T merged 1 commit into
Conversation
Alexandre-T
left a comment
There was a problem hiding this comment.
READY FOR MERGE
Independent review of 9dbbb1b against Story #131, AGENTS.md, the portable Markdown publication contract and the shared LongitudeOne pre-merge Definition of Done.
No blocking finding or unresolved governance gate remains.
Verified:
- All ten library-level roadmap pages are replaced by library indexes. Version landing pages remain; their eight source edits only update the roadmap destination.
- Shared build-time generation replaces body nodes and preserves YAML metadata. Repeated application/build export is idempotent.
- Missing, blank, empty-object and valid no-branch configurations produce the exact fallback message without a timeline or support table. Invalid non-empty inputs fail; fully unannounced branches remain configured.
- Published major landing pages receive branch links in both representations; absent or unpublished destinations remain plain text.
- Historical documentation absent from the support schedule remains reachable through generated version links without inventing branch data.
- Navigation, breadcrumbs/context and version-status messages use the new index resources. Generated HTML status and branch links also resolve correctly under the development
/spatial-docs/base. - Maintainer guidance covers the new target, fallback behavior and version destinations. Roadmap dates, PHP constraints and Packagist version classification are unchanged.
Independent checks:
npm test: 446 passed, 1 skipped, 0 failed.DOCUSAURUS_DEPLOYMENT=development npm run build:local: passed, including the full build and corpus verification (0 errors, 0 warnings).- Markdown lint 0.23.3: 103 files, 0 issues.
git diff --check 2e876e2...HEAD: passed.- Additional isolated check with no configuration directory or display-window file: fallback generation, retained version navigation and source-file preservation passed.
- Inspected generated HTML and Markdown, migration inventory and the version-index diffs.
CI is successful on this SHA: Markdown Lint, documentation-check (including repeated complete-build determinism and the development site), and apache-negotiation.
Visual pre-merge evidence was assessed from the Developer's actual Firefox checks of populated doctrine-spatial and unestablished spatial-transformer in light/dark themes at 1280px and 390px, including horizontal access to the rightmost table columns. I did not repeat the browser session; I independently rebuilt and inspected the generated resources.
No spatial normative behavior or public library API changes. The retirement of separate roadmap URLs is explicitly required by #131. Composer checks are not applicable to this Node.js documentation repository.
This is an independent agent verdict published as a GitHub review comment; it does not merge the PR or mark the Story Done. Merge remains Alexandre's decision.
Pull Request
Summary
Make each library landing page its generated roadmap, replacing the previous overview body. Readers can open documented majors directly from the branch support table while historical documentation remains reachable.
Related issue
Closes #131. Contributes to Epic #125; dependencies #126 and #127 are integrated. Includes the already merged timeline simplifications from #132 through its main-branch base.
Changes
Migrate all ten library roadmaps to
docs/<library>/index.md, remove the separate roadmap pages, and preserve version landing pages. At build time, replace body nodes while retaining YAML front matter; repeated generation is idempotent.Missing or blank JSON,
{}, and valid configurations without branches display The roadmap for this library has not been established yet. They generate no SVG or support table. Malformed non-empty JSON and invalid configurations fail. Fully unannounced branch lists retain the configured-roadmap behavior.Link branch labels to existing published major-version landing pages using portable Markdown or explicit HTML resources. Missing, draft and unlisted landing pages remain plain text. A short list preserves access to documented versions absent from the support schedule, including historical doctrine-spatial v4 and versions of libraries without an established roadmap.
Update navigation, source links, version-status messages and maintainer documentation. Packagist classification, roadmap dates, PHP compatibility and SVG presentation remain unchanged.
Standards and references
References: No normative spatial behavior is affected.
Source and generated content
Validation
Additional validation:
npm test: 446 passed, 1 skipped, 0 failed.npm run build:local: passed; invokesnpm run buildwith explicit local legal test configuration. Documentation corpus: 0 errors, 0 warnings.git diff --check: passed.composer test-localandcomposer quality: not applicable; neither is defined in this documentation repository.9dbbb1b.9dbbb1bd92487ff37a2375cf626a53a303c422c0./spatial-docs/, clean corpus and lint. No blocking findings or Gates.Documentation impact
Library
index.htmlandindex.mdresources become the roadmap landing pages. Separate<library>/roadmap.htmland<library>/roadmap.mdresources are retired as requested by #131; internal links and status messages now target the indexes. Version documentation paths remain available. The roadmap generation and versioning guides describe the new target, fallback behavior and version links.Checklist