Repository navigation
Docs update: comprehensive new-user experience improvements #301
Description
Summary
Implement remaining P0/P1 documentation improvements from the new-user experience audit.
Changes
- New: five-minute-start.md — 5-minute quickstart for absolute beginners
- New: architecture.md — Architecture overview with component explanation
- New: choosing-your-path.md — CLI vs SDK vs Copilot decision guide
- New: glossary.md — Key terms and definitions
- Update: troubleshooting.md — Add common errors table
- Update: first-session.md — Define jargon on first use (spawn, coordinator, Scribe, Ralph)
- Update: navigation.ts — Add new pages to sidebar
Context
Based on new-user experience audit. PRs #286 (validation steps) and #292 (doc-impact review) already merged. Installation decision tree and .squad explainer already present. This PR covers remaining gaps.
Labels: documentation, P0
Reacted by Sturla Thorvaldsson
Activity
docs: comprehensive new-user experience improvements
docs: update focus — OTel Phases 1-3 done, PR github#301 open
bradygaster commentedon Mar 10, 2026
Triage: Docs expansion — new quickstart, architecture, decision guide, glossary pages. Part of new-user experience audit (PRs #286, #292 merged). P1 — high-impact onboarding. @pao can drive.
github-actions commentedon Mar 10, 2026
📋 Assigned to PAO (DevRel)
Issue: #301 — Docs update: comprehensive new-user experience improvements
PAO will pick this up in the next Copilot session.
bradygaster commentedon Mar 10, 2026
Triage by PAO
PR #303 ("Docs update: comprehensive new-user experience improvements") is ready for merge but has merge conflicts that need rebase.
Current state:
Next step: Rebase PR #303 on main and the merge will go through. This is P0 documentation work — unblocks #301 once rebased.
docs: comprehensive new-user experience improvements
docs: comprehensive new-user experience improvements
docs: agent anatomy and hiring checklist (#439)