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

[github-actions]

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

---

🆕 What Changed Since April 27

Notable commits since April 27:

• feat: remove features.mcp-cli flag, rename mount-as-clis to cli-proxy (feat: remove features.mcp-cli flag, rename mount-as-clis to cli-proxy #28842) — Breaking rename: tools.mount-as-clis → tools.cli-proxy, features.mcp-cli removed
• feat: support duration string timeouts (6m, 1h) in mcp_scripts_parser (feat: support duration string timeouts (6m, 1h) in mcp_scripts_parser #28817) — new MCP Scripts timeout format support
• Fix gh aw add not recursively downloading transitive shared imports (Fix gh aw add not recursively downloading transitive shared imports #28834) — bug fix

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.

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 docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md still reference v0.45.5. The current release is v0.71.1.

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

---

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

.github/workflows/agentic-optimization-kit.md exists in the repository, but there is no corresponding page in docs/src/content/docs/patterns/. All comparable workflow kits (agentic-observability-kit, batch-ops, workqueue-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 — sixth consecutive day with no action.

---

🆕 New Documentation Gap (Since April 27)

4. MCP Scripts — Duration string timeout format undocumented

Commit #28817 added support for human-friendly duration strings in the MCP Scripts timeout field (e.g., timeout: 6m, timeout: 1h). The current docs in docs/src/content/docs/reference/mcp-scripts.md (lines 56, 190–204) only document integer seconds:

timeout: 120  # seconds — documented
timeout: 6m   # duration string — NOT documented yet
timeout: 1h   # duration string — NOT documented yet

Relevant doc to update: docs/src/content/docs/reference/mcp-scripts.md

Status: 🆕 New gap — feature shipped today, docs not yet updated.

---

✅ Previously Reported Issues — Resolved

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

---

📋 Summary

Gap	Severity	Age
Provider-based auth (COPILOT_PROVIDER_*) undocumented — #16498	🔴 Critical	3+ months
Stale v0.45.5 install links in blog posts (12 links) — #20391	🟡 Medium	8+ weeks
agentic-optimization-kit missing docs page	🟡 Medium	6 days
MCP Scripts timeout duration string format undocumented (#28817)	🟢 Low	New today

New this report: tools.cli-proxy rename docs appear up-to-date in frontmatter-full.md. One new undocumented feature: MCP Scripts duration string timeouts.

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 · ● 1M · ◷

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