Skip to content

docs: fix documentation drift — add job and stage targets to README, AGENTS.md, and create prompt#548

Merged
jamesadevine merged 1 commit into
mainfrom
docs/fix-target-documentation-drift-320640de69a80be0
May 15, 2026
Merged

docs: fix documentation drift — add job and stage targets to README, AGENTS.md, and create prompt#548
jamesadevine merged 1 commit into
mainfrom
docs/fix-target-documentation-drift-320640de69a80be0

Conversation

@jamesadevine

Copy link
Copy Markdown
Collaborator

…AGENTS.md, and create prompt

All three files (README.md, AGENTS.md, prompts/create-ado-agentic-workflow.md) only documented 'standalone' and '1es' as valid target values, but the compiler has supported 'job' and 'stage' targets (via target: job / target: stage in front matter) since they were added (src/compile/job.rs, src/compile/stage.rs, src/data/job-base.yml, src/data/stage-base.yml). docs/targets.md and docs/front-matter.md correctly documented all four values but the three files above were never updated.

  • README.md: expand target field type column to include 'job' and 'stage'
  • AGENTS.md: update docs/targets.md link description to mention all four targets
  • prompts/create-ado-agentic-workflow.md Step 7: add 'job' and 'stage' rows to the target table and a brief note about trigger-ignore behaviour and job-name prefixing

Summary

Test plan

…AGENTS.md, and create prompt

All three files (README.md, AGENTS.md, prompts/create-ado-agentic-workflow.md)
only documented 'standalone' and '1es' as valid target values, but the compiler
has supported 'job' and 'stage' targets (via target: job / target: stage in
front matter) since they were added (src/compile/job.rs, src/compile/stage.rs,
src/data/job-base.yml, src/data/stage-base.yml). docs/targets.md and
docs/front-matter.md correctly documented all four values but the three files
above were never updated.

- README.md: expand target field type column to include 'job' and 'stage'
- AGENTS.md: update docs/targets.md link description to mention all four targets
- prompts/create-ado-agentic-workflow.md Step 7: add 'job' and 'stage' rows to
  the target table and a brief note about trigger-ignore behaviour and job-name
  prefixing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@jamesadevine jamesadevine merged commit c0ffe5c into main May 15, 2026
12 checks passed
@jamesadevine jamesadevine deleted the docs/fix-target-documentation-drift-320640de69a80be0 branch May 15, 2026 06:05
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.

1 participant