Skip to content

docs: add installation method decision tree - #288

Closed
diberry wants to merge 1 commit into
github:mainfrom
diberry:squad/new-customer-docs-2
Closed

diberry wants to merge 1 commit into
github:mainfrom
diberry:squad/new-customer-docs-2

Conversation

@diberry

@diberry diberry commented Mar 8, 2026

Copy link
Copy Markdown
Contributor

What this PR does

Adds a 'Which method should I use?' decision table to the Installation Guide, helping new users choose between the four installation methods based on their goals.

Changes

Goal Recommended Method Why
Try Squad quickly CLI (npx) Zero install, instant start
Use Squad regularly CLI (global) Available everywhere, faster startup
Stay in your editor VS Code extension Inline AI assistance while coding
Build programmatically SDK (npm package) Full API access for custom workflows

Includes a fallback recommendation for undecided users: Start with the CLI.

Context

This addresses a gap identified in new-user experience testing: after the installation overview, users weren't sure which of the three methods to pick. The decision table provides quick guidance without requiring users to read all three sections.

Closes #287

Suggested reviewers: @diberry, @bradygaster

Adds a 'Which method should I use?' decision table to the installation guide,
helping new users choose between CLI (npx/global), VS Code extension, and SDK
based on their goals.

Closes github#287

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@diberry

diberry commented Mar 8, 2026

Copy link
Copy Markdown
Contributor Author

@bradygaster — PR is ready for review. Adds a decision table to the installation guide helping new users pick the right install method.

1 similar comment
@diberry

diberry commented Mar 8, 2026

Copy link
Copy Markdown
Contributor Author

@bradygaster — PR is ready for review. Adds a decision table to the installation guide helping new users pick the right install method.

@bradygaster

Copy link
Copy Markdown
Collaborator

Thank you @diberry! 🎉 Your 'Which method should I use?' decision tree table has been ported into the new Astro docs site (merged via PR #293). The content is now live at docs/src/content/docs/get-started/installation.md. Great contribution — this makes the installation guide much more actionable for new users!

@bradygaster bradygaster closed this Mar 9, 2026
bradygaster added a commit that referenced this pull request Mar 9, 2026
…post

- Port @diberry's installation decision tree (PR #288) and .squad/ explainer (PR #290) into Astro docs
- Apply Brady's review fixes: sidebar scroll-to-active, CLI text updates, logo fix, Copilot CLI callouts, CI/CD cron safety warning
- Update CONTRIBUTORS.md with @IEvangelist (Astro docs rewrite) and @diberry (4 PRs)
- Add blog post 028: New Docs Site — Built by the Community

Merges community work from:
- PR #293 by @IEvangelist (Astro docs rewrite)
- PR #286, #288, #290, #292 by @diberry (docs improvements)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
bradygaster added a commit that referenced this pull request Mar 9, 2026
- Add David Pine (@IEvangelist) to Code Contributors — PRs #293, #298
- Add Dina Berry (@diberry) to Code Contributors — PRs #286, #288, #290, #292
- Update Tamir Dresher with recent PRs #278-280, #283
- Add Dale Kirby to Code Contributors — PR #243

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
bradygaster added a commit that referenced this pull request Mar 9, 2026
* docs(ai-team): session log and orchestration records

Session: 2026-03-09-docs-push-contributors
Requested by: Brady

Changes:
- Logged PAO orchestration: blog 028 update, CONTRIBUTORS.md refresh
- Logged FIDO orchestration: test baseline verification (22 passing)
- Logged session summary: docs push workflow with PR #300 merge
- No decisions inbox entries to merge

* docs: credit Pine, Dina, Tamir, Kirby on docs contributor page

- Add David Pine (@IEvangelist) to Code Contributors — PRs #293, #298
- Add Dina Berry (@diberry) to Code Contributors — PRs #286, #288, #290, #292
- Update Tamir Dresher with recent PRs #278-280, #283
- Add Dale Kirby to Code Contributors — PR #243

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
diberry pushed a commit to diberry/squad that referenced this pull request Mar 10, 2026
…b#307)

* docs(ai-team): session log and orchestration records

Session: 2026-03-09-docs-push-contributors
Requested by: Brady

Changes:
- Logged PAO orchestration: blog 028 update, CONTRIBUTORS.md refresh
- Logged FIDO orchestration: test baseline verification (22 passing)
- Logged session summary: docs push workflow with PR github#300 merge
- No decisions inbox entries to merge

* docs: credit Pine, Dina, Tamir, Kirby on docs contributor page

- Add David Pine (@IEvangelist) to Code Contributors — PRs github#293, github#298
- Add Dina Berry (@diberry) to Code Contributors — PRs github#286, github#288, github#290, github#292
- Update Tamir Dresher with recent PRs github#278-280, github#283
- Add Dale Kirby to Code Contributors — PR github#243

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

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.

Docs: Add installation method decision tree

2 participants