docs: starlight site#536
Merged
Merged
Conversation
Add two new compile targets that produce reusable ADO YAML templates for embedding agentic stages into existing pipelines: - target: job — generates a job-level template (jobs: at root) that can be included in a flat pipeline or inside a user-defined stage - target: stage — generates a stage-level template (stages: wrapping jobs) for direct inclusion in multi-stage pipelines Key design decisions: - Pool is baked in from front matter (not a template parameter) - dependsOn and condition are set natively at the ADO call site - Job names are prefixed with PascalCase agent name for uniqueness (e.g., DailyReview_Agent, DailyReview_Detection, DailyReview_Execution) - Triggers (on:) are ignored with a warning in template targets - Template parameters only include clearMemory and user-defined params New files: - src/compile/job.rs — JobCompiler implementing the Compiler trait - src/compile/stage.rs — StageCompiler implementing the Compiler trait - src/data/job-base.yml — job-level template derived from base.yml - src/data/stage-base.yml — stage-level template wrapping jobs in stage Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Fix path corruption: use Path::with_extension instead of string replace to derive .lock.yml paths in header comments (avoids corrupting directory names containing '.md') - Fix repos header docs: only check front_matter.repositories (populated by resolve_repos() before compile) instead of also checking front_matter.repos (raw input, may be empty) - Fix Unicode in stage prefix: use is_ascii_alphanumeric() to split on non-ASCII characters, ensuring ADO-valid identifiers (ADO requires [A-Za-z0-9_] for job/stage names) - Add test for Unicode stripping in generate_stage_prefix Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…gets Agent-Logs-Url: https://github.com/githubnext/ado-aw/sessions/fa2ca612-1703-4107-87c3-2b2ec35429b8 Co-authored-by: jamesadevine <4742697+jamesadevine@users.noreply.github.com>
…er paths - CLI now prints 'Generated job template:' and 'Generated stage template:' instead of 'Generated job pipeline:' / 'Generated stage pipeline:' since these targets produce reusable ADO templates, not standalone pipelines. - Header comments in generated job/stage templates now reference the actual output path instead of deriving a path from the input file, fixing incorrect inclusion examples (e.g. showing ./agents/x.lock.yml when the output was at ./x.lock.yml). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Astro 6 + Starlight 0.38 with purple accent theme (Mona Sans font) - 26 content pages: Introduction, Setup, Guides, Reference, Troubleshooting - Agent-friendly endpoints: robots.txt, .well-known/ai.txt, /ai/*.json - starlight-llms-txt plugin for llms.txt/llms-full.txt/llms-small.txt - starlight-links-validator for build-time link checking - GitHub Actions workflow for GitHub Pages deployment - Content adapted from existing docs/ reference pages Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…t version - Primary install path is now downloading pre-built binaries from GH releases - Added platform tabs (Linux x64, macOS arm64, Windows x64) with download scripts - Added checksum verification instructions - Added ado-aw configure step (push → configure → run order) - Documented GitHub PAT temporary limitation (no App token support yet) - Local development page now specifies Rust 1.94.0+ requirement Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace em dashes, en dashes, smart quotes, ellipses, and arrows with their ASCII counterparts across all MDX content to avoid rendering issues. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
The custom Head component was replacing the default entirely, dropping meta charset=utf-8 and other essential tags. Now extends the default Head component and appends custom content. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add dedicated GitHub PAT permissions section to quick start with required fine-grained PAT settings (Copilot Requests: Read, personal account owner). Update CLI configure command docs with Azure CLI fallback behavior and link to permission requirements. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add astro-mermaid integration with autoTheme support (light/dark). Replace text-art pipeline flow diagram in How It Works with a proper Mermaid flowchart. Mermaid renders client-side with no external dependencies. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Rewrite the splash page with outcome-focused copy: security patch PRs, pipeline failure analysis, documentation consistency, work item triage. Add Mermaid security architecture diagram, tabbed agent-file vs compiled pipeline example, CardGrid sections, and clear CTAs to both quick start paths. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Title: Azure DevOps Agentic Workflows, subtitle: Continuous AI for Azure DevOps. Lead immediately with a real agent markdown example (Dependency Guardian) before the outcome copy. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Fix card rendering in light mode with explicit backgrounds, borders, and icon colors. Use theme-neutral Mermaid diagram colors. Style search box for splash pages. Add "Same salad, different dressing" section with gh-aw comparison table and restored footer attribution. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.
Summary
Test plan