Skip to content

fix(docs): add concepts/ and cookbook/ to build, fix broken links (#266)#270

Merged
bradygaster merged 1 commit intomainfrom
squad/266-fix-docs-broken-links
Mar 8, 2026
Merged

fix(docs): add concepts/ and cookbook/ to build, fix broken links (#266)#270
bradygaster merged 1 commit intomainfrom
squad/266-fix-docs-broken-links

Conversation

@bradygaster
Copy link
Copy Markdown
Owner

Summary

Fixes the 403/404 error on the docs site when navigating to Recipes & Advanced Scenarios or any Concepts page.

Root cause: \docs/build.js\ SECTIONS array didn't include \concepts/\ or \cookbook/\ directories — those markdown source files existed but were never built into HTML pages.

Changes

  • *\docs/build.js* — Added \concepts\ (5 pages) and \cookbook\ (1 page) to SECTIONS and SECTION_ORDER
  • *\docs/sdk-first-mode.md* — Fixed dead link: \concepts/routing.md\ → \ eatures/routing.md\ (the file didn't exist)

Broken links fixed (8+)

Source file Broken link Status
reference/cli.md cookbook/recipes.html ✅ Fixed (now builds)
reference/sdk.md cookbook/recipes.html ✅ Fixed (now builds)
get-started/first-session.md concepts/your-team.html ✅ Fixed (now builds)
get-started/first-session.md concepts/memory-and-knowledge.html ✅ Fixed (now builds)
features/github-issues.md concepts/github-workflow.html ✅ Fixed (now builds)
features/human-team-members.md concepts/your-team.html ✅ Fixed (now builds)
features/plugins.md concepts/your-team.html, memory-and-knowledge.html ✅ Fixed (now builds)
sdk-first-mode.md concepts/routing.md (didn't exist) ✅ Redirected to features/routing.md

Verified


  • ode docs/build.js\ generates 99 pages including all 6 new ones
  • All previously-404 pages now build: concepts/your-team, concepts/memory-and-knowledge, concepts/parallel-work, concepts/github-workflow, concepts/portability, cookbook/recipes

Closes #266

- 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>
@bradygaster bradygaster merged commit c5e4f1b into main Mar 8, 2026
1 check failed
jongio pushed a commit to jongio/squad that referenced this pull request Mar 9, 2026
…radygaster#269, bradygaster#270, bradygaster#272)

- Add createCompleter() in src/cli/shell/autocomplete.ts for @agent and /command completion
- Wire completer into readline interface in runShell()
- Add squad loop command with --filter and --interval flags
- Rename squad watch to squad triage (keep watch as silent alias)
- Add squad hire command with --name and --role flags
- Update help text with all new commands

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Recipes & Advanced Scenarios (recipes.html) shows 403 error page

1 participant