Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 19, 2025

The "Agentic campaigns" section was a single 398-line page while peer sections (Guides, Design Patterns, Examples) use subsections. This created navigation inconsistency.

Changes

Split campaigns documentation into focused subsections:

  • Overview (campaigns.md) - Core concepts, orchestrator/worker coordination, design principles
  • Campaign Specs (campaigns/specs.md) - Spec file format, frontmatter configuration, validation
  • Getting Started (campaigns/getting-started.md) - Quick start, walkthrough, issue form approach
  • Project Management (campaigns/project-management.md) - Roadmap views, custom date fields, auto-population
  • CLI Commands (campaigns/cli-commands.md) - Command reference for gh aw campaign

Updated astro.config.mjs sidebar to display subsections:

{
  label: 'Agentic campaigns',
  items: [
    { label: 'Overview', link: '/guides/campaigns/' },
    { label: 'Campaign Specs', link: '/guides/campaigns/specs/' },
    { label: 'Getting Started', link: '/guides/campaigns/getting-started/' },
    { label: 'Project Management', link: '/guides/campaigns/project-management/' },
    { label: 'CLI Commands', link: '/guides/campaigns/cli-commands/' },
  ],
}

Fixed broken anchor link in setup/cli.md pointing to removed section.

Screenshot

Sidebar now matches the structure of other major sections:

Campaigns sidebar with subsections

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
    • Triggering command: `/opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro dev git rev-�� -allow-local-files -o public/slides/index.html into logical subsections for better organization:
  • Overview page with core concepts
  • Campaign Specs for configuration
  • Getting Started for quick start guide
  • Project Mana /opt/hostedtoolcache/node/24.12.0/x64/bin/bash` (dns block)
  • Triggering command: /opt/hostedtoolcache/node/24.12.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro dev git rev-�� s -o public/slides/index.html (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Make new Agentic campaigns top level section in docs consistent with others (Guides, Examples, etc.) in terms of formatting, subsections, etc.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Split campaigns.md into logical subsections for better organization:
- Overview page with core concepts
- Campaign Specs for configuration
- Getting Started for quick start guide
- Project Management for roadmap views
- CLI Commands for command reference

Updated sidebar in astro.config.mjs to show subsections consistent with other major sections like Guides and Design Patterns.

Fixed broken link in setup/cli.md to point to new getting-started page.

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copilot AI changed the title [WIP] Update formatting for Agentic campaigns section in documentation Restructure Agentic campaigns docs into subsections Dec 19, 2025
Copilot AI requested a review from mnkiefer December 19, 2025 21:10
@mnkiefer mnkiefer marked this pull request as ready for review December 19, 2025 21:14
@mnkiefer mnkiefer merged commit 8040f97 into main Dec 19, 2025
126 checks passed
@mnkiefer mnkiefer deleted the copilot/format-agentic-campaigns-section branch December 19, 2025 21:16
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.

2 participants