[docs] Self-healing documentation fixes from issue analysis - 2026-07-21#46934
Conversation
…ude tab Closes #46613 Co-Authored-By: Claude <noreply@anthropic.com>
|
Thanks for the documentation improvement — this is a valid fix addressing issue #46613. However, this PR violates the project's contribution process. Contribution Process ViolationPer CONTRIBUTING.md:
This PR was automatically created by the Daily Documentation Healer workflow. Automated workflows should not bypass the contribution process — documentation gaps should be surfaced as issues or agentic plans, then a core team member implements the fix using their agent. Next StepsPlease:
|
|
✅ Test Quality Sentinel completed test quality analysis. No test files were added or modified in this PR. Test Quality Sentinel skipped. PR #46934 is a documentation-only change (docs/src/content/docs/setup/quick-start.mdx). |
|
✅ Design Decision Gate 🏗️ completed the design decision gate check. No ADR enforcement needed: PR #46934 does not have the 'implementation' label and has 0 new lines of code in business logic directories (threshold: 100). |
|
🧠 Matt Pocock Skills Reviewer has completed the skills-based review. ✅ |
|
✅ PR Code Quality Reviewer completed the code quality review. |
There was a problem hiding this comment.
Pull request overview
Adds Claude OAuth limitations to the quick-start authentication guidance.
Changes:
- Clarifies that
CLAUDE_CODE_OAUTH_TOKENis unsupported and ignored. - Directs users to
ANTHROPIC_API_KEYand keyless authentication guidance.
Show a summary per file
| File | Description |
|---|---|
docs/src/content/docs/setup/quick-start.mdx |
Adds a Claude authentication note. |
Review details
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 1/1 changed files
- Comments generated: 1
- Review effort level: Medium
| 2. Add it as a repository secret from your repository root with `gh secret set ANTHROPIC_API_KEY < /path/to/key.txt`, or use the GitHub UI. See [Authentication](/gh-aw/reference/auth/#anthropic_api_key) for more detail. | ||
|
|
||
| :::note | ||
| Claude subscription OAuth tokens (`CLAUDE_CODE_OAUTH_TOKEN`) are not supported and are ignored if set. Use an `ANTHROPIC_API_KEY` instead. See [Authentication](/gh-aw/reference/auth/#anthropic_api_key) for keyless alternatives. |
There was a problem hiding this comment.
Documentation-only change (4 lines). The note is factually accurate — consistent with auth.mdx line 208 which already documents that CLAUDE_CODE_OAUTH_TOKEN is unsupported and ignored. No logic, no code paths affected. No blocking issues found.
🔎 Code quality review by PR Code Quality Reviewer · 13.9 AIC · ⌖ 4.31 AIC · ⊞ 5.6K
Comment /review to run again
There was a problem hiding this comment.
Documentation note is accurate, well-placed, and uses correct Starlight :::note syntax. No issues found.
🧵 Reviewed using Impeccable skills by Impeccable Skills Reviewer · 13.5 AIC · ⌖ 4.93 AIC · ⊞ 5K
There was a problem hiding this comment.
Skills-Based Review 🧠
Applied /grill-with-docs — one actionable issue found.
📋 Summary
Issue
The added :::note closes a real documentation gap (Issue #46613) — the content and placement are correct. However, the link text "See Authentication for keyless alternatives" points to the wrong anchor. The #anthropic_api_key section covers API key setup, not keyless/WIF authentication; that content is under #anthropic-workload-identity-federation-wif.
Positive Highlights
- ✅ Correct Starlight
:::notesyntax in the right tab - ✅ Verified claim — matches existing documentation in
reference/auth.mdxline 208 - ✅ Good cross-referencing strategy; one anchor fix makes it complete
🧠 Reviewed using Matt Pocock's skills by Matt Pocock Skills Reviewer · 24.4 AIC · ⌖ 4.49 AIC · ⊞ 6.7K
Comment /matt to run again
| :::note | ||
| Claude subscription OAuth tokens (`CLAUDE_CODE_OAUTH_TOKEN`) are not supported and are ignored if set. Use an `ANTHROPIC_API_KEY` instead. See [Authentication](/gh-aw/reference/auth/#anthropic_api_key) for keyless alternatives. | ||
| ::: | ||
| </TabItem> |
There was a problem hiding this comment.
[/grill-with-docs] The link anchor #anthropic_api_key does not lead to keyless/WIF documentation — that lives at #anthropic-workload-identity-federation-wif. Users who follow the link looking for keyless options will land in the wrong section.
💡 Suggested fix
:::note
Claude subscription OAuth tokens (`CLAUDE_CODE_OAUTH_TOKEN`) are not supported and are ignored if set. Use an `ANTHROPIC_API_KEY` instead. For keyless alternatives, see [Anthropic WIF](/gh-aw/reference/auth/#anthropic-workload-identity-federation-wif).
:::This matches the exact wording and anchor used in reference/auth.mdx line 208.
@copilot please address this.
|
🎉 This pull request is included in a new release. Release: |
Summary
Adds a clarifying note to the quick-start guide's Claude tab informing users that
CLAUDE_CODE_OAUTH_TOKEN(Claude subscription OAuth tokens) are not supported and will be ignored if set. Directs users to useANTHROPIC_API_KEYinstead, with a link to the auth reference for keyless alternatives.Changes
docs/src/content/docs/setup/quick-start.mdx:::noteblock under the Anthropic API key setup sectionDetails
docs/setup/quick-start.mdx— Anthropic (Claude) tab onlyThis addresses user confusion where setting
CLAUDE_CODE_OAUTH_TOKEN(used by Claude Code CLI) has no effect in gh-aw, which requiresANTHROPIC_API_KEY.