Repository navigation
docs(router): archive 18 stale/superseded docs - #551
Merged
Merged
Conversation
ivogt
added a commit
that referenced
this pull request
Jun 9, 2026
Bring in main (#540-#551: dev/prod matching stability + lazy-include fixes, perf benchmarks, docs reorg/archive, release 0.0.0-experimental.116). Resolve the two internal docs-map conflicts (feature-file-map.md, feature-map.md) by keeping main's cell updates AND the branch's testing rows (the "Consumer testing primitives" row and the six ./testing* export-surface rows). Gate: typecheck 12/12, test:unit:all EXIT=0 (router 3537 + 6 todo, cloudflare-basic 39, RSC 27), lint 0/0, format.
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
Moves 18 stale docs — completed action-plans, applied handoffs, superseded research, and shipped RFCs — out of the live docs into an
archive/folder, so the maintained doc set only contains things that describe current, shipped reality. Docs-only,[skip ci].This is the same instinct behind the matching-doc reframe: point-in-time process scaffolding rots as "current" docs. The flagging came from the classification pass (47 docs reviewed; these 18 were marked archive-candidates with evidence — self-labeled "Status: Implemented/Superseded", shipped PRs, old
rsc-routerpackage names).Where things went
Two
archive/folders, one per doc tree (the docs span both):docs/archive/← 8 root docs:MIDDLEWARE_SPEC,design/cf-cache-store, the threeresearch/build-chunking-*,rfc-use-fetch-loader,rsc-caching-design,trailing-slash-researchpackages/rangojs-router/docs/internal/archive/← 10 internal docs: the*-handoff,*-review-actions,*-action-plan,*-remediation-plan,test-quality-*,stability-next-steps-planHow it's safe
git mvpreserves history (git tracked all 18 as renames, ~98–99% similarity even with the added banner).> **Archived.**banner at the top — with a "superseded by / shipped in #N" pointer where one applies (e.g.clientChunks→ commit2a5eb679;prerender-passthrough→Passthrough()wrapper;rsc-caching-design→docs/design/caching.md).README.md(3 nav links) andstability-roadmap.md(2 refs) — now point at thearchive/paths and are marked(archived). README gained a one-line pointer tointernal/archive/.stability-next-steps-plan↔ the review/plan docs) were same-tree, so a same-folder move keeps them resolving.cf-cache-store"references" were the source filecf-cache-store.ts, not the doc.Test plan
formatclean;[skip ci].Third and final tranche of the doc-voice/cleanup work: #549 (9 "why" docs), #550 (11 light-touch), this (18 archived).