Skip to content

docs: fix architecture tree, network domain attribution, and workspace defaults reference#353

Merged
jamesadevine merged 2 commits into
mainfrom
copilot/fix-documentation-drift-another-one
Apr 29, 2026
Merged

docs: fix architecture tree, network domain attribution, and workspace defaults reference#353
jamesadevine merged 2 commits into
mainfrom
copilot/fix-documentation-drift-another-one

Conversation

Copilot AI commented Apr 29, 2026

Copy link
Copy Markdown
Contributor

Resolves three findings from the weekly documentation freshness audit: a missing crate in the architecture tree, an incorrect source attribution for host.docker.internal, and a dangling cross-reference in the workspace: field documentation.

Summary

  • AGENTS.md — Added the ado-aw-derive/ proc-macro crate (provides #[derive(SanitizeConfig)] / #[derive(SanitizeContent)]) to the architecture tree, where it was absent despite being a top-level workspace member used throughout src/safeoutputs/.
  • docs/network.md — Reworded the default-allowed-domains table header to clarify that host.docker.internal is not part of CORE_ALLOWED_HOSTS. It is injected by the standalone compiler in generate_allowed_domains (src/compile/common.rs) because standalone always uses MCPG. Also annotated the row itself.
  • docs/front-matter.md — Replaced the dangling "see below" in the workspace: example comment with the actual rule, and added a new ## Workspace Defaults subsection documenting the auto-computed default:
    • checkout: empty → defaults to root
    • checkout: has entries → defaults to repo

Test plan

Documentation-only changes; no code paths affected. Verified rendered markdown and cross-references locally.

…e defaults reference

Agent-Logs-Url: https://github.com/githubnext/ado-aw/sessions/30b5ebbc-f42c-4ff2-bc93-d56f6f5593a4

Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix documentation drift in architecture tree and network domains docs: fix architecture tree, network domain attribution, and workspace defaults reference Apr 29, 2026
Copilot AI requested a review from jamesadevine April 29, 2026 13:45
@jamesadevine jamesadevine marked this pull request as ready for review April 29, 2026 13:53
@jamesadevine jamesadevine merged commit 15fdedd into main Apr 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

📝 Documentation drift detected — architecture tree, network.md domain attribution, dangling workspace reference

2 participants