Description
The Quick Start secret-setup steps tell a brand-new user to run gh secret set COPILOT_GITHUB_TOKEN < /path/to/token.txt. A complete beginner does not know what /path/to/token.txt means, how to create it, or where to put it — the docs-noob tester got stuck exactly here. Verified in docs/src/content/docs/setup/quick-start.mdx:
- Line 81:
gh secret set COPILOT_GITHUB_TOKEN < /path/to/token.txt
- Line 87:
gh secret set ANTHROPIC_API_KEY < /path/to/key.txt
Suggested approach
Use the more intuitive echo-pipe form (and keep the GitHub-UI alternative), e.g.:
echo "ghp_YourTokenHere" | gh secret set COPILOT_GITHUB_TOKEN
Expected Impact
Removes the first real stumbling block in onboarding; the token-setup step becomes copy-pasteable without inventing a file.
Suggested Agent
Docs maintenance agent (e.g. Daily Documentation Updater) or a general code agent.
Estimated Effort
Fast (< 30 min).
Data Source
DeepReport 2026-06-18; Documentation Noob Test Report #39985 (Critical #1). Distinct from the open PAT-acronym item (#39814).
Generated by 🔬 DeepReport - Intelligence Gathering Agent · ◷
Description
The Quick Start secret-setup steps tell a brand-new user to run
gh secret set COPILOT_GITHUB_TOKEN < /path/to/token.txt. A complete beginner does not know what/path/to/token.txtmeans, how to create it, or where to put it — the docs-noob tester got stuck exactly here. Verified indocs/src/content/docs/setup/quick-start.mdx:gh secret set COPILOT_GITHUB_TOKEN < /path/to/token.txtgh secret set ANTHROPIC_API_KEY < /path/to/key.txtSuggested approach
Use the more intuitive echo-pipe form (and keep the GitHub-UI alternative), e.g.:
Expected Impact
Removes the first real stumbling block in onboarding; the token-setup step becomes copy-pasteable without inventing a file.
Suggested Agent
Docs maintenance agent (e.g. Daily Documentation Updater) or a general code agent.
Estimated Effort
Fast (< 30 min).
Data Source
DeepReport 2026-06-18; Documentation Noob Test Report #39985 (Critical #1). Distinct from the open PAT-acronym item (#39814).