Skip to content

docs: fix broken anchor link in execution-context.md - #2284

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-ado-script-anchor-link-1dbf98093346e7b8
Draft

github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-ado-script-anchor-link-1dbf98093346e7b8

Conversation

@github-actions

@github-actions github-actions Bot commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

Agent Documentation Update

Findings

Area Issue File(s)
structure Internal cross-reference link used a double-hyphen anchor (#agent-job-runtime-import-resolver--pr-context-precompute) that does not match the actual heading slug generated from ### Agent job (runtime-import resolver + PR-context precompute) in docs/ado-script.md (the + collapses to a single hyphen, not two), so the link silently fails to resolve for both GitHub rendering and any agent/tool that validates in-repo markdown anchors. docs/execution-context.md

Applied Fixes

  • Corrected the anchor to #agent-job-runtime-import-resolver-pr-context-precompute, matching the actual heading slug in docs/ado-script.md.

Notes

Verified by writing a small script that extracts every markdown heading across docs/**/*.md and AGENTS.md, computes the GitHub-style slug for each, and cross-checks every relative/anchor link in those files against the resulting slug set. This was the only broken link found; a full pass also confirmed:

  • Every docs/*.md page is reachable from the AGENTS.md documentation index and vice versa.
  • The AGENTS.md architecture tree (src/, scripts/ado-script/src/, etc.) matches the current file layout exactly (no stale or missing entries).
  • CLI subcommands/flags in docs/cli.md match the clap Commands enum in src/main.rs.
  • All safe-output tools in src/safe_outputs/ are documented in docs/safe-outputs.md.
  • FrontMatter/EngineConfig/ToolsConfig/NetworkConfig/PipelineParameter struct fields match docs/front-matter.md, docs/engine.md, docs/tools.md, docs/network.md, and docs/parameters.md.
  • prompts/*.md claims (no compiler-selected default model, synthetic/policy PR modes) were verified against src/engine.rs and src/compile/types.rs and are accurate.

No other inconsistencies were found; this was the one concrete, verifiable structural defect in the current agent-facing documentation set.


Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · auto · 188.5 AIC · ⌖ 8.6 AIC · ⊞ 13.3K · ◷

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