[Daily Report] Documentation Quality Report — April 27, 2026

[github-actions]

Daily status report on documentation quality for the gh-aw project, cross-referenced against open issues.

---

🆕 What Changed Since April 26

Notable commits since April 26:

• fix(docs-noob-tester) — Replace STATUS=$(curl) with until curl to survive set -e (fix(docs-noob-tester): replace STATUS=$(curl) with until curl to survive set -e #28624) — docs tooling fix
• docs: rename skip link anchor — #_top → #main-content (WCAG 2.4.1) (docs: rename skip link anchor #_top → #main-content (WCAG 2.4.1) #28618) — accessibility improvement
• Add gh aw run guidance and CLI commands reference (Add gh aw run guidance and CLI commands reference #28616) — new docs content for gh aw run guidance

Closed since last report: No documentation issues closed.

---

🐛 Open Documentation Issues

1. #16498 — Provider-based authentication for Claude, Copilot, Codex (open since Feb 2026)

Labels: documentation, enhancement, security, cli

CLAUDE_CODE_OAUTH_TOKEN and COPILOT_PROVIDER_* environment variables remain largely undocumented. Users wanting Azure/Anthropic/OpenAI custom model providers have no guidance on how to configure provider-based authentication in their workflows.

Relevant docs to update: docs/src/content/docs/reference/auth.mdx, docs/src/content/docs/reference/engines.md, docs/src/content/docs/reference/environment-variables.md

Status: ❌ Critical gap — BYOK shipped 3+ months ago; still undocumented.

---

2. #20391 — Stale v0.45.5 version links in blog posts (open since March 2026)

Labels: documentation, automation, workflows

Install links in blog post files under docs/src/content/docs/blog/ reference a specific pinned version (v0.45.5) that is no longer current. No automation exists to keep these links updated.

Relevant docs: docs/src/content/docs/blog/ — all blog post entries referencing install steps

Status: ❌ Ongoing — stale install links unaddressed for 8+ weeks.

---

3. agentic-optimization-kit — No documentation page (gap first noted Apr 23)

The workflow .github/workflows/agentic-optimization-kit.md exists in the repository, but there is no corresponding page in docs/src/content/docs/patterns/. All comparable workflows (agentic-observability-kit, batch-ops, workqueue-ops, task-ops, daily-ops, etc.) each have a dedicated docs page.

Relevant doc location to create: docs/src/content/docs/patterns/agentic-optimization-kit.md

Status: ❌ Gap persists — fifth consecutive day with no action.

---

✅ Previously Reported Issues — Resolved

Issue	Resolution
#23957 docs: add audit command reference page	✅ Closed as completed (Apr 2)
#27501 Trigger cadence clarifying question	✅ Closed as completed (Apr 21)
#27502 Bash allowlist decision rule	✅ Closed as completed (Apr 21)
#27823 Mobile code block overflow	✅ Closed

---

i️ Issues Where Documentation Already Has the Answer

Issue	Status
#22001 WorkQueueOps/BatchOps pages	Both workqueue-ops.md and batch-ops.md exist in docs/src/content/docs/patterns/. Recommendation: close with pointer to the docs pages.

---

📋 Summary

Gap	Severity	Age
Provider-based auth (COPILOT_PROVIDER_*) undocumented — #16498	🔴 Critical	3+ months
Stale v0.45.5 install links in blog posts — #20391	🟡 Medium	8+ weeks
agentic-optimization-kit missing docs page	🟡 Medium	5 days

New this report: No new documentation issues opened. One new docs addition landed (gh aw run guidance, #28616).

Note

🔒 Integrity filter blocked 10 items

The following items were blocked because they don't meet the GitHub integrity level.

• #20593 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19080 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #24422 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21436 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #27259 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21130 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #19099 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21188 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21242 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22533 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Dev · ● 509.9K · ◷

• expires on May 4, 2026, 9:35 AM UTC