[docs] Self-healing documentation fixes from issue analysis - 2026-07-18#46314
Conversation
Closes #46004 Co-Authored-By: Claude <noreply@anthropic.com>
github-actions
Bot
added
automation
documentation
🤖 PR Triage
Self-healing documentation fixes from automated issue analysis. Low-risk docs-only change. Batch: standalone
|
|
🧠 Matt Pocock Skills Reviewer has completed the skills-based review. ✅ |
|
✅ PR Code Quality Reviewer completed the code quality review. |
|
✅ Design Decision Gate 🏗️ completed the design decision gate check. No ADR enforcement needed: PR #46314 does not have the 'implementation' label and has 0 new lines of code in business logic directories (threshold: 100). |
|
✅ Test Quality Sentinel completed test quality analysis. No test files were added or modified in this PR. Test Quality Sentinel skipped. (PR #46314 is a documentation-only change to docs/src/content/docs/introduction/how-they-work.mdx) |
There was a problem hiding this comment.
Pull request overview
Adds a compact authentication table to the engine introduction, addressing issue #46004.
Changes:
- Documents frontmatter values and authentication requirements for four engines.
- Links each authentication method to its reference documentation.
Show a summary per file
| File | Description |
|---|---|
docs/src/content/docs/introduction/how-they-work.mdx |
Adds the per-engine authentication table. |
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
| | Engine | Frontmatter `engine:` | Secret or permission required | | ||
| |---|---|---| | ||
| | Copilot (default) | `copilot` | [`copilot-requests: write`](/gh-aw/reference/auth/#copilot-requests-write-permission) permission or [`COPILOT_GITHUB_TOKEN`](/gh-aw/reference/auth/#copilot_github_token) | | ||
| | Claude | `claude` | [`ANTHROPIC_API_KEY`](/gh-aw/reference/auth/#anthropic_api_key) | |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
No blocking issues. The added authentication table is accurate, well-placed, and includes a reference link. No code changes.
🔎 Code quality review by PR Code Quality Reviewer · 7.52 AIC · ⌖ 4.25 AIC · ⊞ 5.6K
Comment /review to run again
There was a problem hiding this comment.
Docs-only change adding a per-engine auth table to how-they-work.mdx. All anchor links verified against reference/auth.mdx — every #anchor resolves to an existing section header. The Codex row correctly reflects the CODEX_API_KEY/OPENAI_API_KEY fallback behaviour. No issues found.
🧵 Reviewed using Impeccable skills by Impeccable Skills Reviewer · 13.7 AIC · ⌖ 4.26 AIC · ⊞ 5K
There was a problem hiding this comment.
Skills-Based Review
Applied /grill-with-docs — the change is well-scoped and terminology aligns with the existing auth reference. All anchor links in auth.mdx resolve correctly. APPROVE.
🧠 Reviewed using Matt Pocock's skills by Matt Pocock Skills Reviewer · 20.2 AIC · ⌖ 4.26 AIC · ⊞ 6.7K
Comment /matt to run again
|
🎉 This pull request is included in a new release. Release: |
Summary
Adds a per-engine authentication reference table to the AI Engines section of how-they-work.mdx.
Changes
Motivation
Users setting up non-default engines had to navigate to the authentication reference to discover which secret was required. The new table surfaces this information inline at the point where engines are first introduced.