From 353e06bcf0b64ac113e83376655041770ceb3a50 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 22 May 2026 21:08:46 +0000
Subject: [PATCH] docs(site): remove invalid workflow_dispatch trigger from
 quick-start example
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

workflow_dispatch is a GitHub Actions key with no meaning in ado-aw.
OnConfig only accepts schedule, pipeline, and pr — unknown keys are
silently dropped. The minimal example now omits on: entirely and a
callout explains the ADO manual-queuing model.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 site/src/content/docs/setup/quick-start.mdx | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/site/src/content/docs/setup/quick-start.mdx b/site/src/content/docs/setup/quick-start.mdx
index 1bb12b0e..0423a261 100644
--- a/site/src/content/docs/setup/quick-start.mdx
+++ b/site/src/content/docs/setup/quick-start.mdx
@@ -119,8 +119,6 @@ name: Hello from ado-aw
 description: A minimal agentic pipeline example
 engine:
   id: copilot
-on:
-  workflow_dispatch:
 pool: AZS-1ES-L-MMS-ubuntu-22.04
 ---
 
@@ -131,6 +129,10 @@ Inspect the repository and summarize what this project does.
 
 This file combines YAML front matter for configuration with markdown instructions for the agent.
 
+:::note[Manual queuing]
+All Azure DevOps pipelines can be queued manually from the ADO UI — no special `on:` configuration is needed for that. The `on:` key is for automatic triggers such as schedules (`on.schedule:`), PR events (`on.pr:`), or upstream pipeline completion (`on.pipeline:`). Omitting `on:` means the pipeline only runs when you queue it manually (plus any CI triggers ADO applies by default).
+:::
+
 ### 2. Compile it
 
 ```bash