docs: fix broken links in docs/tools.md and docs/network.md - #2228
Draft
github-actions[bot] wants to merge 1 commit into
Draft
github-actions[bot] wants to merge 1 commit into
github-actions[bot] wants to merge 1 commit into
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Agent Documentation Update
Findings
docs/network.mdlinks todocs/tools.md#built-in-clis, but the actual heading is## Host-provided CLIs(slughost-provided-clis) — the anchor never resolveddocs/network.mddocs/tools.mdlinks to a non-existent smoke pipelinetests/safe-outputs/azure-cli.md; no such file exists anywhere in the repo's git history. The real smoke pipeline that exercises the wrappedazCLI path istests/smoke/ado-proxy.mddocs/tools.mdApplied Fixes
docs/tools.mdanchor reference indocs/network.mdto point at#host-provided-clistests/safe-outputs/azure-cli.mdindocs/tools.mdwith a correct link totests/smoke/ado-proxy.md, and updated the surrounding sentence to accurately describe what that pipeline proves (wrappedaz devops/az restcalls through the credential-isolatedado-proxy, not "authenticated direct ADO access" claims)Notes
Verified via:
docs/*.md+AGENTS.mdmarkdown link with a#anchor, confirming#built-in-cliswas the only broken internal anchor..mdlink indocs/*.md,AGENTS.md, andprompts/*.md, confirmingtests/safe-outputs/azure-cli.mdwas the only dead file reference;git log --followshows it was never committed.tests/smoke/ado-proxy.mdis a real, registered smoke case (tests/smoke/cases.json) that runsaz devops project showandaz restagainst the ado-proxy-wrapped CLI, matching the surrounding prose's intent.No other
docs/,AGENTS.md, orprompts/*.mdinconsistencies 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 thecontainer_runtime.rsAGENTS.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.