[docs] Self-healing documentation fixes from issue analysis - 2026-03-15

[github-actions]

Self-Healing Documentation Fixes

This PR was automatically created by the Daily Documentation Healer workflow.

Gaps Fixed

• gh aw domains CLI command undocumented — Added a new #### domains section to the Monitoring section of docs/src/content/docs/setup/cli.md. PR Add gh aw domains command to list network domains configured in workflows #21086 (merged 2026-03-15T16:26Z) added the domains command (pkg/cli/domains_command.go) but touched no documentation files.

• safe-outputs.allowed-url-domains field undocumented — Expanded the Text Sanitization section of docs/src/content/docs/reference/safe-outputs.md to document the new allowed-url-domains field. PR Add safe-outputs.allowed-url-domains for additive URL domain allowlisting #21083 (merged 2026-03-15T18:34Z) added additive URL domain allowlisting for safe-outputs but included no documentation update.

Root Cause

DDUw ran at ~04:31 UTC on 2026-03-15 and produced PR #21025. Both #21086 and #21083 were merged at 16:26Z and 18:34Z respectively — more than 12 hours after DDUw completed. This is the sixth consecutive healer run identifying the same late-UTC-day blind-spot pattern: features merged in the afternoon UTC window fall entirely outside DDUw's single early-morning scan.

DDUw Improvement Suggestions

1. Run DDUw twice daily (e.g. 06:00 UTC and 20:00 UTC) to halve the blind-spot window. Prior healer runs [docs] Self-healing documentation fixes from issue analysis - 2026-03-09 #20254, [docs] Self-healing documentation fixes from issue analysis - 2026-03-10 #20412, [docs] Self-healing documentation fixes from issue analysis - 2026-03-11 #20569, [docs] Self-healing documentation fixes from issue analysis - 2026-03-12 #20716, and [docs] Self-healing documentation fixes from issue analysis - 2026-03-14 #20980 have all identified this same root cause — the pattern persists across 6 consecutive runs with no remediation.
2. Add a late-day scan trigger: A workflow_dispatch or a second cron: "0 20 * * *" entry in the DDUw schedule would catch the afternoon merge window.
3. Extend scan window to 36 hours with deduplication so that a late-UTC-day merge is still caught by the next day's DDUw run even when the look-back window doesn't reach it.

Analyzed Issues (last 7 days, label: documentation, state: closed)

Issue	Title	Action
#21017	Multi-Device Docs Testing Report - 2026-03-15	Automated testing report, not a doc gap
#20968	GHES: Create prerequisites guide and troubleshooting runbook	Closed not_planned — explicitly deprioritized
#20797	[cli-consistency] CLI Consistency Issues - 2026-03-13	not_planned — CLI binary help text, not docs/
#20675	[cli-consistency] CLI Consistency Issues - 2026-03-12	not_planned — CLI binary help text, not docs/
#20663	dependencies: documentation undersells APM	Addressed by Copilot PR #20674 (confirmed by healer #20716)
#20646	Invalid HTML anchor in CONTRIBUTING.md	Addressed by Copilot PR #20681 (confirmed by healer #20716)
#20522	[cli-consistency] CLI Consistency Issues - 2026-03-11	not_planned — CLI binary help text
#20370	[cli-consistency] Help Flag Descriptions	Addressed (confirmed by healer #20569)
#20248	Improve actionability of failure issues	Addressed by PR #20266 (confirmed by prior healer)
#20241	Staged mode needs better docs	Addressed by PR #20269 (confirmed by prior healer)
#20218	[cli-consistency] Missing Flags	Addressed (confirmed by prior healer)
#20041	[Daily Report] Daily Status Report — 2026-03-08	Automation report, not a doc gap
#19937	[Daily Report] Daily Status Report - 2026-03-07	Automation report, not a doc gap
#19815	[ubuntu-image] research: update Ubuntu runner image analysis	Research task, not a documentation gap

The two documented gaps were discovered by cross-referencing today's post-DDUw commits against the documentation files.

Files Changed

• docs/src/content/docs/setup/cli.md — added gh aw domains command documentation in the Monitoring section
• docs/src/content/docs/reference/safe-outputs.md — added allowed-url-domains field to the Text Sanitization section, with usage example and explanation of additive vs. replacement semantics

Related

• Add gh aw domains command to list network domains configured in workflows #21086 — Add gh aw domains command to list network domains configured in workflows (merged 2026-03-15T16:26Z, after DDUw's ~04:31Z run)
• Add safe-outputs.allowed-url-domains for additive URL domain allowlisting #21083 — Add safe-outputs.allowed-url-domains for additive URL domain allowlisting (merged 2026-03-15T18:34Z, after DDUw's ~04:31Z run)
• [docs] Update documentation for features from 2026-03-15 #21025 — DDUw PR for 2026-03-15 (did not cover Add gh aw domains command to list network domains configured in workflows #21086 or Add safe-outputs.allowed-url-domains for additive URL domain allowlisting #21083 due to timing)
• [docs] Self-healing documentation fixes from issue analysis - 2026-03-14 #20980 — Previous doc-healer PR (same late-merge timing pattern, sixth recurrence)

References:

• §23117320908

Generated by Daily Documentation Healer · ◷

• expires on Mar 18, 2026, 7:20 PM UTC