Skip to content

Docs: clarify Quick Start install fallback options and add-wizard vs add - #55971

Closed
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/deep-report-clarify-install-options
Closed

Docs: clarify Quick Start install fallback options and add-wizard vs add#55971
pelikhan with Copilot wants to merge 2 commits into
mainfrom
copilot/deep-report-clarify-install-options

Conversation

Copilot AI commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

First-time users following the Quick Start guide couldn't tell that the curl-script/gh auth login options were fallback-only troubleshooting paths, and the distinction between gh aw add-wizard and gh aw add was buried in prose, making it hard to notice both commands exist.

Tip box: fallback options

  • Reworded the Step 1 install Tip box to explicitly state it's a fallback path, self-contained even when the box is skimmed in isolation:
> [!TIP]
> **Fallback options only — skip this unless the command above fails.** If you are encountering authentication issues, use this script instead:

add-wizard vs add: up-front comparison

  • Added a short comparison table at the top of Step 2, ahead of the existing prose explanation, so both commands are visible immediately:
Command Use it when
gh aw add-wizard Guided, interactive prompts for engine/auth/secrets (used in this guide)
gh aw add Non-interactive, e.g. scripts or CI

The CLI Commands reference page already had an equivalent comparison table, so no changes were needed there.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Clarify fallback options in Quick Start installation Docs: clarify Quick Start install fallback options and add-wizard vs add Aug 26, 2026
Copilot AI requested a review from pelikhan August 26, 2026 07:05
@github-actions

Copy link
Copy Markdown
Contributor

Triage update: Category: docs | Risk: low | Score: 28/100 (impact 10 + urgency 6 + quality 12) | Action: defer | Batch: workflow-runtime

Generated by 🔧 PR Triage Agent · copilot · mai10 · 17.1 AIC · ⌖ 2.78 AIC · ⊞ 15.6K ·

@github-actions

Copy link
Copy Markdown
Contributor

Triage update: Category: docs | Risk: low | Score: 28/100 (impact 10 + urgency 6 + quality 12) | Action: defer | Batch: workflow-runtime

Generated by 🔧 PR Triage Agent · copilot · mai10 · 17.1 AIC · ⌖ 2.78 AIC · ⊞ 15.6K ·

@pelikhan pelikhan closed this Aug 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[deep-report] Clarify Quick Start install fallback options and add-wizard vs add naming for first-time users

2 participants