Repository navigation
docs: concepts banner removal, nav restructure, build test sync (WS-B) - #1571
Merged
Merged
Conversation
- Remove⚠️ Experimental banners from all 6 concepts pages - Fix 'Fully unattended' → 'Event-driven' for cloud heartbeat in github-workflow.md - Restructure navigation.ts: Get Started 3 items, Concepts at position 2, Features split Core/Advanced/Infrastructure - Delete features/remote-control.md (replaced by features/squad-rc.md) - Delete guide/personal-squad.md and guide/shell.md (REPL/global-mode artifacts) - Update docs/tests/build-output.test.mjs knownSections to match new nav structure Supersedes part of #1426 Working as PAO (DevRel) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
🛫 PR Readiness Check
PR Scope: 🔧 Infrastructure
|
| Status | Check | Details |
|---|---|---|
| ✅ | Single commit | 1 commit — clean history |
| ✅ | Not in draft | Ready for review |
| ✅ | Branch up to date | Up to date with dev |
| ❌ | Copilot review | No Copilot review yet — it may still be processing |
| ✅ | Changeset present | No source files changed — changeset not required |
| ✅ | Scope clean | No .squad/ or docs/proposals/ files |
| ✅ | No merge conflicts | No merge conflicts |
| ✅ | Copilot threads resolved | No Copilot review threads |
| ❌ | CI passing | 1 check(s) still running |
Files Changed (11 files, +327 −1782)
| File | +/− |
|---|---|
docs/src/content/docs/concepts/architecture.md |
+49 −71 |
docs/src/content/docs/concepts/github-workflow.md |
+1 −63 |
docs/src/content/docs/concepts/memory-and-knowledge.md |
+0 −74 |
docs/src/content/docs/concepts/parallel-work.md |
+3 −94 |
docs/src/content/docs/concepts/portability.md |
+0 −85 |
docs/src/content/docs/concepts/your-team.md |
+3 −79 |
docs/src/content/docs/features/remote-control.md |
+0 −326 |
docs/src/content/docs/guide/personal-squad.md |
+0 −352 |
docs/src/content/docs/guide/shell.md |
+0 −343 |
docs/src/navigation.ts |
+65 −64 |
docs/tests/build-output.test.mjs |
+206 −231 |
Total: +327 −1782
This check runs automatically on every push. Fix any ❌ items and push again.
See CONTRIBUTING.md and PR Requirements for details.
Contributor
🟡 Impact Analysis — PR #1571Risk tier: 🟡 MEDIUM 📊 Summary
🎯 Risk Factors
📦 Modules Affecteddocs (11 files)
This report is generated automatically for every PR. See #733 for details. |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR continues the docs overhaul strategy (WS‑B of #1426 follow-up) by cleaning up Concepts pages, restructuring the docs sidebar navigation, and syncing the build-output test expectations to match the new nav section taxonomy.
Changes:
- Removed the “
⚠️ Experimental” banner block from 6 Concepts pages and made small wording adjustments (e.g., cloud heartbeat wording). - Restructured
NAV_SECTIONSto promote Concepts and split Features into Core / Advanced / Infrastructure, plus renamed “Guide” → “Guides” and consolidated Recipes. - Updated
docs/tests/build-output.test.mjsknownSectionsto reflect the new navigation section titles.
Show a summary per file
| File | Description |
|---|---|
| docs/tests/build-output.test.mjs | Updates Pagefind section taxonomy expectations to match the new nav section titles. |
| docs/src/navigation.ts | Restructures sidebar navigation: Concepts promoted; Features split; Guides updated; Scenarios reordered. |
| docs/src/content/docs/concepts/architecture.md | Removes experimental banner and tightens formatting. |
| docs/src/content/docs/concepts/github-workflow.md | Removes experimental banner; updates “Fully unattended” → “Event-driven” wording for cloud heartbeat. |
| docs/src/content/docs/concepts/memory-and-knowledge.md | Removes experimental banner and tightens formatting. |
| docs/src/content/docs/concepts/parallel-work.md | Removes experimental banner; updates @copilot wording (“autonomous” → background/async framing). |
| docs/src/content/docs/concepts/portability.md | Removes experimental banner and tightens formatting. |
| docs/src/content/docs/concepts/your-team.md | Removes experimental banner and tightens formatting; small wording adjustments. |
| docs/src/content/docs/features/remote-control.md | Deletes deprecated/retired page (per PR description, replaced by squad-rc). |
| docs/src/content/docs/guide/personal-squad.md | Deletes retired page. |
| docs/src/content/docs/guide/shell.md | Deletes REPL/shell artifact page. |
Review details
- Files reviewed: 11/11 changed files
- Comments generated: 2
- Review effort level: Lite
Comment on lines
+51
to
+56
| { | ||
| title: 'Advanced Features', | ||
| dir: 'features', | ||
| items: [ | ||
| { title: 'Ceremonies', slug: 'features/ceremonies' }, | ||
| { title: 'Reviewer Protocol', slug: 'features/reviewer-protocol' }, |
Comment on lines
68
to
+71
| { title: 'Streams', slug: 'features/streams' }, | ||
| { title: 'Git Worktrees', slug: 'features/worktrees' }, | ||
| { title: 'Squad RC', slug: 'features/squad-rc' }, | ||
| ], |
Collaborator
Author
RETRO Gate Review — WS-B (#1571)Reviewer: RETRO (Security) | Date: 2026-08-02T18:49:04-07:00 | Adjudication ref: pr-1426-gate-adjudication.md Gate Checklist
Verdict✅ APPROVE TO MERGE All RETRO blocking gates pass. Copilot bot reviewed all 11 files substantively. npm test passes with updated knownSections. Logical author is PAO per commit trailers. CI fully green. No dead links, no PII, no prohibited language. WS-D (get-started) should target merge after this PR per design review sequencing. RETRO — Security. Thorough but pragmatic. These gates are real risks, not hypothetical ones. |
This was referenced Aug 3, 2026
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.
Summary
Concepts page cleanup and navigation restructure. This is WS-B of the four-part #1426 replacement strategy (see design review). WS-D (get-started) should merge after this PR.
File Scope
docs/src/content/docs/concepts/architecture.mdgithub-workflow.mdmemory-and-knowledge.mdparallel-work.mdportability.mdyour-team.mddocs/src/navigation.tsdocs/tests/build-output.test.mjsfeatures/remote-control.md(→ squad-rc.md),guide/personal-squad.md,guide/shell.mdChanges Applied
⚠️ **Experimental**banners removed from all 6 concepts pagesgithub-workflow.md—Fully unattended→Event-drivenfor cloud heartbeat descriptionremote-control.md(squad-rc is the live replacement),personal-squad.md,shell.md(REPL artifacts)knownSectionsinbuild-output.test.mjsupdated to match new nav sectionsSlug Integrity Verified
All navigation slugs confirmed to exist on branch:
features/state-backends✅,features/dual-mode-deployment✅scenarios/release-process✅,scenarios/scaling-workstreams✅features/squad-rc✅ (replacement for deleted remote-control)Validation
npm run buildindocs/: ✅ passes (indexed 170 pages, 0 errors)npm testindocs/: ✅ 13 pass, 0 fail (Playwright skipped — missing Chromium in CI, pre-existing)remote-control.mdin any concepts fileIssue References
No issue close keywords. Structural PR.
Supersedes part of #1426
Working as PAO (DevRel)