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

[github-actions]

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

---

What Changed Since April 28

Notable commits (April 28–29):

• docs: document add-labels safe-output capability in create-agentic-workflow.md (docs: document add-labels safe-output capability in create-agentic-workflow.md #29054) — new add_labels safe-output documented ✅
• docs(faq): add billing, spend controls, and loop cost entries ([FAQ] Add: billing model, spend controls, and loop cost FAQ entries #29023) — FAQ expanded with cost-related questions ✅
• feat: Add CorrectionOps pattern (feat: Add CorrectionOps pattern #29058) — new pattern + docs page correction-ops.md created ✅
• feat(logs): add --after flag to clean up cached run folders (feat(logs): add --after flag to clean up cached run folders older than a date delta #29037) — new CLI flag, no accompanying doc PR ⚠️

---

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.

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

12 links in the meet-the-workflows blog post still reference v0.45.5. Current release is significantly newer.

Relevant doc: docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md

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

---

3. #22001 — WorkQueueOps and BatchOps doc pages

Both workqueue-ops.md and batch-ops.md now exist in docs/src/content/docs/patterns/, which may mean this issue is already resolved.

Status: 🟡 May be resolved — needs triage to confirm and close.

---

4. #29048 — Add path-filtered pull_request trigger example (opened today)

Labels: ai-generated, plan, cookie

Request to add a pull_request trigger with paths: filtering to .github/aw/create-agentic-workflow.md. Backend/QA engineers need examples for triggering workflows only for specific file changes (e.g., db/migrations/*.sql).

Relevant doc: .github/aw/create-agentic-workflow.md — existing pull_request trigger section

Status: 🆕 New today — assigned to Copilot.

---

New Documentation Gaps (Since April 28)

5. gh aw logs --after flag undocumented

Commit #29037 added a new --after flag to gh aw logs for cleaning up cached run folders older than a given date delta. No docs PR was submitted alongside the feature.

Relevant doc to update: docs/src/content/docs/reference/logs.md (or equivalent)

Status: 🆕 New gap — feature shipped today, undocumented.

---

6. Missing docs page: agentic-optimization-kit (gap persists — 7th day)

.github/workflows/agentic-optimization-kit.md exists in the repository, but there is no corresponding page in docs/src/content/docs/patterns/. All comparable kits have dedicated docs pages.

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

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

---

Resolved Since April 28

Change	Details
add_labels safe-output documented	Added in #29054 to create-agentic-workflow.md
FAQ cost entries	Billing, spend controls, loop cost added in #29023
CorrectionOps pattern + docs page	Added in #29058

---

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	7 days
gh aw logs --after flag undocumented (#29037)	🟢 Low	New today
Path-filtered pull_request trigger example — #29048	🟢 Low	New today, assigned
#22001 WorkQueueOps/BatchOps docs	🟢 May be resolved	Needs triage

Positive note: Good documentation activity today — add_labels safe-output docs, FAQ billing entries, and the CorrectionOps pattern page all landed.

Note

🔒 Integrity filter blocked 4 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".
• #10305 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #22939 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #21243 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 · ● 845.9K · ◷

• expires on May 6, 2026, 9:36 AM UTC