Objective
Add a brief 1–2 sentence "Why a separate token?" explainer before the COPILOT_GITHUB_TOKEN PAT creation steps in Quick Start Step 2.
Context
Discussion #43686 (Documentation Noob Tester report, issue #3) flagged that the note currently says "a separate GitHub token with Copilot access — distinct from the default GITHUB_TOKEN" with no further explanation. For a beginner, the existence of two different GitHub tokens is confusing without context for why they are different.
File to Modify
docs/src/content/docs/setup/quick-start.mdx
Implementation Plan
Approach
- Open
quick-start.mdx and find the COPILOT_GITHUB_TOKEN Note block.
- Before the PAT creation steps, add a short callout or sentence such as:
Why a separate token? The default GITHUB_TOKEN provided by Actions has limited scopes and cannot call the GitHub Copilot API. A Personal Access Token (PAT) with Copilot access lets the workflow authenticate to the AI engine on your behalf.
- Keep it brief — 2 sentences maximum — to avoid adding too much prose to an already dense step.
Files to Modify
docs/src/content/docs/setup/quick-start.mdx
Acceptance Criteria
Generated by 📋 Plan Command · 27.1 AIC · ⌖ 10.7 AIC · ⊞ 4.9K · ◷
Comment /plan to run again
Objective
Add a brief 1–2 sentence "Why a separate token?" explainer before the COPILOT_GITHUB_TOKEN PAT creation steps in Quick Start Step 2.
Context
Discussion #43686 (Documentation Noob Tester report, issue #3) flagged that the note currently says "a separate GitHub token with Copilot access — distinct from the default GITHUB_TOKEN" with no further explanation. For a beginner, the existence of two different GitHub tokens is confusing without context for why they are different.
File to Modify
docs/src/content/docs/setup/quick-start.mdxImplementation Plan
Approach
quick-start.mdxand find the COPILOT_GITHUB_TOKEN Note block.Files to Modify
docs/src/content/docs/setup/quick-start.mdxAcceptance Criteria
GITHUB_TOKENfrom a PAT