Skip to content

docs: fix broken links in docs/tools.md and docs/network.md - #2228

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-tools-broken-links-2e10e54c566f2496
Draft

github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-tools-broken-links-2e10e54c566f2496

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Agent Documentation Update

Findings

Area Issue File(s)
accuracy docs/network.md links to docs/tools.md#built-in-clis, but the actual heading is ## Host-provided CLIs (slug host-provided-clis) — the anchor never resolved docs/network.md
accuracy docs/tools.md links to a non-existent smoke pipeline tests/safe-outputs/azure-cli.md; no such file exists anywhere in the repo's git history. The real smoke pipeline that exercises the wrapped az CLI path is tests/smoke/ado-proxy.md docs/tools.md

Applied Fixes

  • Fixed the docs/tools.md anchor reference in docs/network.md to point at #host-provided-clis
  • Replaced the dead link to tests/safe-outputs/azure-cli.md in docs/tools.md with a correct link to tests/smoke/ado-proxy.md, and updated the surrounding sentence to accurately describe what that pipeline proves (wrapped az devops / az rest calls through the credential-isolated ado-proxy, not "authenticated direct ADO access" claims)

Notes

Verified via:

  • A scripted anchor-resolution audit across every docs/*.md + AGENTS.md markdown link with a #anchor, confirming #built-in-clis was the only broken internal anchor.
  • A scripted file-existence audit across every relative .md link in docs/*.md, AGENTS.md, and prompts/*.md, confirming tests/safe-outputs/azure-cli.md was the only dead file reference; git log --follow shows it was never committed.
  • Confirmed tests/smoke/ado-proxy.md is a real, registered smoke case (tests/smoke/cases.json) that runs az devops project show and az rest against the ado-proxy-wrapped CLI, matching the surrounding prose's intent.

No other docs/, AGENTS.md, or prompts/*.md inconsistencies were found in this pass (CLI commands, front-matter fields, safe-output tools, execution-context contributors, and the extension registry all matched their source of truth). Several other doc-drift gaps already have open PRs (e.g. #2223/#2203/#2198 for the container_runtime.rs AGENTS.md tree entry, #2207 for ado-script bundle inventory, #2202 for network ecosystem identifiers, #2201 for mcp-author tool surface, #2197 for the safe-outputs footer, #2190 for reserved parameter names, #2226 for the IR canonical shape) — this run intentionally avoided duplicating those.


Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · auto · 143.6 AIC · ⊞ 11.9K ·

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
2 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

This branch has not been deployed

No deployments
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.

0 participants