[Daily Report] Documentation Quality Report — May 3, 2026

[github-actions]

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

---

Open Documentation Issues — 2026-05-03

Issues with Documentation Relevance

#	Title	Finding
#16498	Provider-based authentication for Claude, Copilot, Codex	⚠️ Partially documented — reference/auth.mdx covers API key secrets but lacks provider-based OAuth (e.g. CLAUDE_CODE_OAUTH_TOKEN) and cloud-provider auth. Gap remains.
#20391	Meet-the-workflows blog points to pinned versions, needs automation	i️ No dedicated doc for auto-updating version links. Blog posts still use pinned SHA-based gh aw add-wizard URLs. Infrastructure gap (no automated link-checker).
#29545	Docs rendering broken on Android Chrome with large fonts	🐛 UI/CSS issue on the docs site — not a content problem. Needs frontend fix in docs/ Astro/Starlight config.
#29551	gh aw compile emits artifact actions unsupported on GHES	⚠️ troubleshooting/debug-ghe.md exists but does not mention artifact version incompatibility. Content gap in GHES troubleshooting page.
#29784	Document concurrency group pattern in create-agentic-workflow.md	✅ Already documented — reference/concurrency.md has a full table of concurrency groups per trigger type. Issue could be closed pointing to that page.
#29785	Add workflow_run vs pull_request trigger decision guide	⚠️ reference/triggers.md describes workflow_run syntax but has no decision guide comparing it to pull_request. Gap in guidance content.

---

Issues Where Documentation Already Answers the Question

These issues may be closable with a pointer to existing docs:

• [plan] Document concurrency group pattern in create-agentic-workflow.md #29784 — The concurrency group pattern is fully documented in reference/concurrency.md. The issue asks to add it to .github/aw/create-agentic-workflow.md; that file is an internal template, not the public docs site. The public reference page is comprehensive — consider closing with a link.

---

Documentation Gaps (No Coverage Found)

Gap	Relevant Issue	Suggested Location
Provider-based / OAuth token auth for Claude	#16498	reference/auth.mdx — add section on CLAUDE_CODE_OAUTH_TOKEN and cloud-provider auth
GHES artifact v4+ incompatibility and workaround	#29551	troubleshooting/debug-ghe.md — add note on artifact action version constraints
workflow_run vs pull_request trigger decision guide	#29785	reference/triggers.md — add decision matrix or callout
Automated blog version-link maintenance	#20391	New guide or blog post on link-checking workflow

---

Recurring Issues from Previous Reports

The same issues appeared in the May 1 and May 2 daily reports: #16498 and #20391 remain open and unaddressed. Both are medium-complexity improvements with no assigned owner.

---

Summary

• 4 documentation gaps identified (auth, GHES, trigger guide, link automation)
• 1 issue potentially closable ([plan] Document concurrency group pattern in create-agentic-workflow.md #29784 — concurrency already documented)
• 1 rendering bug (Docs problem on android Chrome with large user fonts #29545 — CSS/UI fix needed, not content)
• Documentation coverage is generally good; main weakness is absence of decision guides and GHES-specific guidance.

Generated by Dev for issue #29626 · ● 647.9K · ◷

• expires on May 10, 2026, 10:11 PM UTC