Skip to content

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

Closed
github-actions[bot] wants to merge 1 commit into
mainfrom
doc-healer/domains-command-and-allowed-url-domains-2026-03-15-f9a2cb153b151444
Closed

[docs] Self-healing documentation fixes from issue analysis - 2026-03-15#21105
github-actions[bot] wants to merge 1 commit into
mainfrom
doc-healer/domains-command-and-allowed-url-domains-2026-03-15-f9a2cb153b151444

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Self-Healing Documentation Fixes

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

Gaps Fixed

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)

IssueTitleAction
#21017Multi-Device Docs Testing Report - 2026-03-15Automated testing report, not a doc gap
#20968GHES: Create prerequisites guide and troubleshooting runbookClosed not_planned — explicitly deprioritized
#20797[cli-consistency] CLI Consistency Issues - 2026-03-13not_planned — CLI binary help text, not docs/
#20675[cli-consistency] CLI Consistency Issues - 2026-03-12not_planned — CLI binary help text, not docs/
#20663dependencies: documentation undersells APMAddressed by Copilot PR #20674 (confirmed by healer #20716)
#20646Invalid HTML anchor in CONTRIBUTING.mdAddressed by Copilot PR #20681 (confirmed by healer #20716)
#20522[cli-consistency] CLI Consistency Issues - 2026-03-11not_planned — CLI binary help text
#20370[cli-consistency] Help Flag DescriptionsAddressed (confirmed by healer #20569)
#20248Improve actionability of failure issuesAddressed by PR #20266 (confirmed by prior healer)
#20241Staged mode needs better docsAddressed by PR #20269 (confirmed by prior healer)
#20218[cli-consistency] Missing FlagsAddressed (confirmed by prior healer)
#20041[Daily Report] Daily Status Report — 2026-03-08Automation report, not a doc gap
#19937[Daily Report] Daily Status Report - 2026-03-07Automation report, not a doc gap
#19815[ubuntu-image] research: update Ubuntu runner image analysisResearch 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

References:

Generated by Daily Documentation Healer ·

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

Document two user-facing features merged on 2026-03-15 after DDUw's
04:31 UTC scan:
- gh aw domains (PR #21086): new CLI command to list effective network
domains for each workflow, including ecosystem-expanded domains and
engine defaults. Added to the Monitoring section of cli.md.
- safe-outputs.allowed-url-domains (PR #21083): new safe-outputs field
that additively extends the URL sanitization domain allowlist (unions
with the engine/network base set). Distinct from allowed-domains, which
replaces the default set. Updated the Text Sanitization section of
safe-outputs.md.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actionsgithub-actionsBot added automation documentation Improvements or additions to documentation labels Mar 15, 2026
@pelikhan
pelikhan deleted the doc-healer/domains-command-and-allowed-url-domains-2026-03-15-f9a2cb153b151444 branch August 18, 2026 23:23
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automationdocumentationImprovements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@pelikhan