From 9aaaf1efc73d2efed81183b1c97b10b5d3d376ad Mon Sep 17 00:00:00 2001 From: bradygaster Date: Sun, 8 Mar 2026 07:28:41 -0700 Subject: [PATCH] fix(docs): add concepts/ and cookbook/ to build, fix broken links (#266) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add concepts/ (5 pages) and cookbook/ (1 page) to SECTIONS in build.js - Add SECTION_ORDER entries for proper sidebar navigation - Fix dead link in sdk-first-mode.md: concepts/routing.md → features/routing.md - This resolves 8+ broken links across the docs site including the 403 on recipes.html Closes #266 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/build.js | 4 ++++ docs/sdk-first-mode.md | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/build.js b/docs/build.js index 24e9b95d1..ba3e3cbb6 100644 --- a/docs/build.js +++ b/docs/build.js @@ -38,6 +38,8 @@ const SECTIONS = [ { dir: 'features', title: 'Features' }, { dir: 'reference', title: 'Reference' }, { dir: 'scenarios', title: 'Scenarios' }, + { dir: 'concepts', title: 'Concepts' }, + { dir: 'cookbook', title: 'Cookbook' }, { dir: 'blog', title: 'Blog' }, ]; @@ -57,6 +59,8 @@ const SECTION_ORDER = { ], 'reference': ['cli', 'sdk', 'config'], 'scenarios': ['existing-repo', 'solo-dev', 'issue-driven-dev', 'monorepo', 'ci-cd-integration', 'team-of-humans', 'aspire-dashboard'], + 'concepts': ['your-team', 'memory-and-knowledge', 'parallel-work', 'github-workflow', 'portability'], + 'cookbook': ['recipes'], }; // Parse optional YAML-style frontmatter (--- fenced) diff --git a/docs/sdk-first-mode.md b/docs/sdk-first-mode.md index 040e53a42..b60ecac48 100644 --- a/docs/sdk-first-mode.md +++ b/docs/sdk-first-mode.md @@ -832,5 +832,5 @@ export default defineSquad({ ## See Also - [SDK Reference](./reference/sdk.md) — all SDK exports -- [Routing Guide](./concepts/routing.md) — deep dive on routing tiers +- [Routing Guide](./features/routing.md) — deep dive on routing tiers - [Governance & Hooks](./sdk/tools-and-hooks.md) — hook pipeline and governance