From 884b251792e354292a7e32e23e23976e1b0f753d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 1 Sep 2026 16:59:35 +0000 Subject: [PATCH] docs(site): fix sample agent example drift from examples/sample-agent.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- site/src/content/docs/guides/examples.mdx | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/site/src/content/docs/guides/examples.mdx b/site/src/content/docs/guides/examples.mdx index ee6ea182..df392697 100644 --- a/site/src/content/docs/guides/examples.mdx +++ b/site/src/content/docs/guides/examples.mdx @@ -15,7 +15,7 @@ A minimal example demonstrating the basic structure of an agent file. **Key features:** - Simple daily schedule trigger -- Repository checkout using the `repos:` shorthand +- Explicit repository checkout - Basic workspace setup - Straightforward agent prompt @@ -27,8 +27,10 @@ name: "Daily Code Review" description: "Reviews code changes and creates summary reports" on: schedule: daily -repos: - - my-org/my-repo +repositories: + - repository: azure-devops-agentic-pipelines + type: git + name: azure-devops-agentic-pipelines workspace: repo --- @@ -44,7 +46,14 @@ Review the latest code changes in the repository and provide feedback. ``` :::tip[repos: shorthand] -`repos:` is the current recommended syntax for repository checkout. The legacy `repositories:` format is automatically rewritten to `repos:` on the next `ado-aw compile`. See [Repositories (repos:)](/ado-aw/reference/front-matter/#repositories-repos) for the full syntax. +This example predates the current `repos:` shorthand and still uses the legacy `repositories:` + `checkout:` form shown above. Both are accepted — the legacy form is automatically rewritten to `repos:` the next time you run `ado-aw compile`. For new agents, prefer the compact `repos:` syntax: + +```yaml +repos: + - my-org/my-repo +``` + +See [Repositories (repos:)](/ado-aw/reference/front-matter/#repositories-repos) for the full syntax. ::: ## ADO work item triage