You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
π Documentation Quality β Daily Status Report
Date: 2026-03-23 | Scope: gh-aw documentation health Note: This is a second report for today, incorporating new findings from #22363 (posted at 02:52 UTC, after the initial report #22350 at 01:17 UTC).
Summary
Category
Count
Open documentation issues tracked
4
New findings since previous report
1
Persistent unresolved bugs
1 (broken architecture link)
Expiring plans (today)
2
Issues answerable by existing docs
0
Documentation gaps confirmed
2
π΄ Open Issues Reporting Documentation Problems
1. Broken Architecture Link β Still Unresolved (Day 2) β οΈ
Status: Open, unresolved for 2 days. Expires 2026-03-24.
Problem:docs/src/content/docs/index.mdx:47 links to /gh-aw/introduction/architecture (no trailing slash) β HTTP 404. With Astro's trailingSlash: 'always', this breaks 8+ pages. The actual page exists at /gh-aw/introduction/architecture/.
Fix: One-line change in docs/src/content/docs/index.mdx line 47 β add trailing slash to the href.
Corresponding doc:docs/src/content/docs/introduction/architecture.mdx β exists and is correct.
2. π FeatureGrid Overflow on iPad Pro 11 (NEW since last report)
Status: Open, expires 2026-03-23T15:32:40Z (~12 hours from report time).
Problem:docs/src/content/docs/reference/engines.md covers per-engine config but has no cross-engine capability comparison. Confirmed: grepping engines.md for "Engine Feature", "max-turns", "plugins" returns nothing.
4. Frontmatter Field Name Validation (Plan Expired Today 05:06 UTC)
Issue:#22092 β [plan] Add frontmatter field name validation with did-you-mean suggestions [plan]
Status: Open, expired 2026-03-23T05:06:31Z (expired ~2 hours before this report).
Problem: Users write agent: instead of engine:, mcp-servers: instead of tools:, tool-sets: instead of toolsets: β compiler silently ignores these.
Current doc state:docs/src/content/docs/reference/frontmatter.md lists valid fields but contains no "common mistakes" section or warning about ignored fields. docs/src/content/docs/troubleshooting/common-issues.md has no unknown-field guidance either.
Quick doc win available (no compiler work needed): Add a "Common Frontmatter Field Name Mistakes" callout to troubleshooting/common-issues.md.
π Documentation Quality β Daily Status Report
Date: 2026-03-23 | Scope: gh-aw documentation health
Note: This is a second report for today, incorporating new findings from #22363 (posted at 02:52 UTC, after the initial report #22350 at 01:17 UTC).
Summary
π΄ Open Issues Reporting Documentation Problems
1. Broken Architecture Link β Still Unresolved (Day 2)β οΈ
Issue: #22226 β π Multi-Device Docs Testing Report - 2026-03-22
[documentation, testing]Status: Open, unresolved for 2 days. Expires 2026-03-24.
Problem:
docs/src/content/docs/index.mdx:47links to/gh-aw/introduction/architecture(no trailing slash) β HTTP 404. With Astro'strailingSlash: 'always', this breaks 8+ pages. The actual page exists at/gh-aw/introduction/architecture/.Fix: One-line change in
docs/src/content/docs/index.mdxline 47 β add trailing slash to thehref.Corresponding doc:
docs/src/content/docs/introduction/architecture.mdxβ exists and is correct.2. π FeatureGrid Overflow on iPad Pro 11 (NEW since last report)
Issue: #22363 β π Multi-Device Docs Testing Report - 2026-03-23
[documentation, testing]Status: Open, posted at 02:52 UTC today (after previous daily report).
Problem: The
.feature-grid.columns-3component indocs/src/components/FeatureGrid.astrouses:At 834px (iPad Pro 11), Starlight's layout gives ~760px content width, but 3 Γ 320px + gaps = 1000px required. Card 3 is clipped/hidden in every row.
Recommended fix: Raise breakpoint to
72remor useauto-fitwithminmax(min(20rem, 100%), 1fr).Also noted: Missing skip-to-main-content link (WCAG 2.4.1 compliance gap).
Cross-reference: No existing doc covers FeatureGrid responsiveness β this is a code fix in the component itself.
3. Missing Engine Feature Comparison Table π Plan Expires Today (15:32 UTC)
Issue: #22147 β [plan] Add engine feature comparison table to engines reference docs
[plan]Status: Open, expires 2026-03-23T15:32:40Z (~12 hours from report time).
Problem:
docs/src/content/docs/reference/engines.mdcovers per-engine config but has no cross-engine capability comparison. Confirmed: greppingengines.mdfor "Engine Feature", "max-turns", "plugins" returns nothing.Planned table from issue:
max-turnsmax-continuationspluginsweb-searchweb-fetchCorresponding doc:
docs/src/content/docs/reference/engines.mdβ file exists, section missing.4. Frontmatter Field Name Validation (Plan Expired Today 05:06 UTC)
Issue: #22092 β [plan] Add frontmatter field name validation with did-you-mean suggestions
[plan]Status: Open, expired 2026-03-23T05:06:31Z (expired ~2 hours before this report).
Problem: Users write
agent:instead ofengine:,mcp-servers:instead oftools:,tool-sets:instead oftoolsets:β compiler silently ignores these.Current doc state:
docs/src/content/docs/reference/frontmatter.mdlists valid fields but contains no "common mistakes" section or warning about ignored fields.docs/src/content/docs/troubleshooting/common-issues.mdhas no unknown-field guidance either.Quick doc win available (no compiler work needed): Add a "Common Frontmatter Field Name Mistakes" callout to
troubleshooting/common-issues.md.ποΈ Cross-Reference: Issues vs. Documentation
docs/src/content/docs/index.mdx:47docs/src/components/FeatureGrid.astrodocs/src/layouts/or Starlight configdocs/src/content/docs/reference/engines.mddocs/src/content/docs/reference/frontmatter.mdNo issues found where documentation already fully answers the question. All four tracked issues represent genuine actionable bugs or gaps.
π Trend vs. Previous Report (#22350, 2026-03-23 01:17 UTC)
Recommended Actions (Priority Order)
docs/src/content/docs/index.mdx:47β resolves π Multi-Device Docs Testing Report - 2026-03-22Β #22226FeatureGrid.astrobreakpoint from50remto72remfor 3-col grid β resolves π Multi-Device Docs Testing Report - 2026-03-23Β #22363 FeatureGrid overflowtroubleshooting/common-issues.mdβ partially addresses [plan] Add frontmatter field name validation with did-you-mean suggestions for common mistakesΒ #22092engines.mdβ resolves [plan] Add engine feature comparison table to engines reference docsΒ #22147 before plan expires todayGenerated by Daily Status Report workflow β 2026-03-23
Note
π Integrity filter blocked 7 items
The following items were blocked because they don't meet the GitHub integrity level.
search_issuessearch_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".To allow these resources, lower
min-integrityin your GitHub frontmatter: