docs: sync README/ROADMAP/ARCHITECTURE with what's actually shipped#37
Merged
CodeWithJuber merged 1 commit intoJul 8, 2026
Merged
Conversation
- README.md: replace the stale "GitLab Pages landing page" section with an accurate "Public site" section describing both landing/index.html (the new professional landing page) and public/index.html (the generated status page), the shared design system gated by forge uicheck design/visual, and both Pages deployments (GitHub Pages gets both pages, GitLab Pages gets the status page only). - ROADMAP.md: fix the stale v0.5.0 "Now" header (actual: v0.6.0), move the already-shipped embeddings tier and public-site redesign out of "Next" into a new "Shipped — 0.6.0" section, and trim the Playwright loop bullet to just its still-open remainder. - ARCHITECTURE.md: add the three modules missing from the repo-layout component map (embed.js, ledger_read.js, taste.js) and note the public-site build (landing/, scripts/build-pages.mjs, static.yml, .gitlab-ci.yml). Docs-only; no source changes.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
The user flagged that "all documents, md files and other things are not updated with our implementation." Grepping README.md, ROADMAP.md, and ARCHITECTURE.md against the real repo state on
masterconfirmed specific, concrete staleness:## GitLab Pages landing pagedescribed only the old setup (public/index.htmlstatus page via.gitlab-ci.yml) — it said nothing about the newlanding/index.htmlprofessional redesign (PR Professional redesign of the landing + status pages, gated by forge's own UI system #36), the shared design system gated byforge uicheck design/forge uicheck visual, or the live GitHub Pages deployment (.github/workflows/static.yml) that serves the landing page at the site root and the status page at/status/. The section title itself was wrong —public/index.htmlis titled "forgekit status", not a landing page.v0.5.0version header (actual:0.6.0) and listed the embeddings tier and Playwright loop as open## Nextwork when both are already fully shipped (perCHANGELOG.md's[Unreleased]section, merged in PR Roadmap "Next" wave: ledger read-path flip, optional embeddings tier, Playwright visual gate #35). The public-site redesign wasn't mentioned anywhere.embed.js,ledger_read.js,taste.js) and didn't mention the public-site build system at all.This PR is a docs-only sync — no source changes. Verified as already accurate and left untouched:
CHANGELOG.md(already documents everything correctly; cutting a version is the owner-runbump.ymlAction, out of scope here),docs/GUIDE.md,ONBOARDING.md.Checklist
npm testpasses (Node 18/20/22) — no source changes, existing suite unaffectednpm run checkpasses (Biome lint + format) — markdown-only, not covered by Biomefeat:/fix:/docs:…)CHANGELOG.mdupdated under## [Unreleased]— n/a, this PR is a docs-accuracy fix, not a feature; nothing shipped that needs a changelog entryforge substrate,forge impact, router/gate, or MCP substrate tools — n/a, but docs updated regardlessRisk & rollback
.mdfiles)Extra checks (tick if applicable)
npm run typecheckpasses — n/a, no.js/.tschangesmasterbefore writing, not assumedGenerated by Claude Code