Objective
Consolidate the four sequential API key Note callouts in Quick Start Step 2 into a single tabbed/collapsed section so beginners only see the setup steps relevant to their chosen engine.
Context
Discussion #43686 (Documentation Noob Tester report) identified this as the top critical issue: four sequential collapsed Note blocks (COPILOT_GITHUB_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) in Quick Start Step 2 create visual noise and anxiety — a beginner reading the docs doesn't know they only need one of these.
Screenshot: https://github.com/github/gh-aw/blob/assets/Documentation-Noob-Tester/d8e1dd2f36a7925052ac53cfe1c21f9b83810372015de9563d612c8acc51fa91.png?raw=true
File to Modify
docs/src/content/docs/setup/quick-start.mdx
Implementation Plan
Approach
- Locate Step 2 in
quick-start.mdx where the four API key notes currently appear.
- Replace the four separate Note blocks with a single tabbed component (e.g., Starlight's
<Tabs>/<TabItem> components, or an equivalent collapsible structure already used in the docs).
- Tabs should be labeled: Copilot, Claude (Anthropic), OpenAI, Gemini — each tab shows only that engine's token/key setup instructions.
- Add a brief lead-in sentence before the tabs: "Choose the AI engine you set up earlier and follow the corresponding instructions."
Files to Modify
docs/src/content/docs/setup/quick-start.mdx — replace the four sequential Note callouts with a tabbed section
Acceptance Criteria
Generated by 📋 Plan Command · 27.1 AIC · ⌖ 10.7 AIC · ⊞ 4.9K · ◷
Comment /plan to run again
Objective
Consolidate the four sequential API key Note callouts in Quick Start Step 2 into a single tabbed/collapsed section so beginners only see the setup steps relevant to their chosen engine.
Context
Discussion #43686 (Documentation Noob Tester report) identified this as the top critical issue: four sequential collapsed Note blocks (COPILOT_GITHUB_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY) in Quick Start Step 2 create visual noise and anxiety — a beginner reading the docs doesn't know they only need one of these.
Screenshot: https://github.com/github/gh-aw/blob/assets/Documentation-Noob-Tester/d8e1dd2f36a7925052ac53cfe1c21f9b83810372015de9563d612c8acc51fa91.png?raw=true
File to Modify
docs/src/content/docs/setup/quick-start.mdxImplementation Plan
Approach
quick-start.mdxwhere the four API key notes currently appear.<Tabs>/<TabItem>components, or an equivalent collapsible structure already used in the docs).Files to Modify
docs/src/content/docs/setup/quick-start.mdx— replace the four sequential Note callouts with a tabbed sectionAcceptance Criteria