Skip to content

Add documentation improvement campaign to track all doc-related workflows#6974

Closed
Copilot wants to merge 3 commits intomainfrom
copilot/track-documentation-updates
Closed

Add documentation improvement campaign to track all doc-related workflows#6974
Copilot wants to merge 3 commits intomainfrom
copilot/track-documentation-updates

Conversation

Copy link
Contributor

Copilot AI commented Dec 19, 2025

Creates a campaign specification to coordinate 7 documentation workflows under unified tracking with automated work discovery via tracker-id markers.

Campaign Specification

  • ID: documentation-improvement
  • Project Board: GitHub Project remove max-runs #65 (manual creation required)
  • Tracker Label: campaign:documentation-improvement
  • Auto-generated Orchestrator: Discovers work via tracker-id search, updates project board, generates metrics

Workflows Coordinated

  1. daily-doc-updater - Auto-updates docs from merged PRs
  2. unbloat-docs - Reduces verbosity while maintaining clarity
  3. daily-multi-device-docs-tester - Tests responsive design across devices
  4. developer-docs-consolidator - Consolidates specs into developer instructions
  5. docs-noob-tester - Tests getting-started experience
  6. glossary-maintainer - Maintains term definitions
  7. technical-doc-writer - Improves technical documentation

Changes

  • Created .github/workflows/documentation-improvement.campaign.md with full campaign spec
  • Added tracker-id field to 5 workflows missing it (unbloat-docs, developer-docs-consolidator, docs-noob-tester, glossary-maintainer, technical-doc-writer)
  • Recompiled all affected workflows and generated orchestrator

Discovery Pattern

The orchestrator uses tracker-id markers to find work:

# Each workflow embeds tracker-id in XML comments
<!-- agentic-workflow: WorkflowName, tracker-id: unbloat-docs, ... -->

# Orchestrator queries across all workers
repo:owner/repo "tracker-id: unbloat-docs" OR "tracker-id: glossary-maintainer" ... in:body

All discovered issues/PRs get labeled campaign:documentation-improvement and added to the project board automatically.

Activation

Manually create GitHub Project #65 with Status/Priority/Type fields. The orchestrator runs daily at 6pm UTC to maintain board state.

Original prompt

Considering all the documentation related agentic workflows, generate a campaign that spans them to keep track of all documentation updates and improvements that are happening agentically.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI self-assigned this Dec 19, 2025
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copilot AI changed the title [WIP] Add campaign to track documentation updates and improvements Add documentation improvement campaign to track all doc-related workflows Dec 19, 2025
Copilot AI requested a review from mnkiefer December 19, 2025 15:20
@mnkiefer
Copy link
Contributor

Coin campaigns to "Agentic campaigns" so as not to be confused with other github campaigns and make it top level in the documentation.

@mnkiefer
Copy link
Contributor

Postpone for now.

@mnkiefer mnkiefer closed this Dec 19, 2025
@mnkiefer mnkiefer deleted the copilot/track-documentation-updates branch January 5, 2026 08:23
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