Skip to content

Fix label naming inconsistency and document workflow migration requirements#6893

Merged
jstirnaman merged 2 commits intoclaude/triage-agent-plan-EOY0ufrom
copilot/sub-pr-6890
Mar 1, 2026
Merged

Fix label naming inconsistency and document workflow migration requirements#6893
jstirnaman merged 2 commits intoclaude/triage-agent-plan-EOY0ufrom
copilot/sub-pr-6890

Conversation

Copy link
Contributor

Copilot AI commented Mar 1, 2026

Addresses feedback on the document review pipeline implementation plan regarding label taxonomy clarity and migration requirements.

Changes

  • Label naming: Renamed review:approvedapproval:codeowner to distinguish human approval workflow state from automated review/* outcome labels

    • Added explanatory note to prevent implementor confusion about the distinct prefix choice
  • Workflow migration requirements: Documented GitHub Actions files requiring updates when migrating sync-plugin-docssource:auto-detected

    • .github/workflows/sync-plugins.yml (lines 28, 173, 421)
    • .github/ISSUE_TEMPLATE/sync-plugin-docs.yml (line 4)

Context

The original plan used both review: (colon) and review/ (slash) prefixes, which would confuse both humans and automation. The rename creates clear separation:

Category Prefix Examples
Human approval workflow approval: approval:codeowner
Automated review outcomes review/ review/approved, review/changes-requested

The sync-plugin-docs label is actively used in automation workflows that would break silently after label migration without explicit documentation of required updates.


💡 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.

- Rename review:approved to approval:codeowner to avoid confusion with review/* labels
- Add note explaining the distinct prefix to prevent implementor confusion
- Document required workflow updates for sync-plugin-docs label migration
- Specify exact files and line numbers that need updating

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 1, 2026

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

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:

  • https://api.github.com/graphql
    • Triggering command: /usr/bin/gh gh pr view copilot/sub-pr-6890 --json title,body (http block)

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

Copilot AI changed the title [WIP] Update document review pipeline implementation plan Fix label naming inconsistency and document workflow migration requirements Mar 1, 2026
| `approval:codeowner` | Codeowner approved |

> [!Note]
> The `approval:codeowner` label uses a distinct prefix (`approval:`) to avoid confusion with the `review/*` labels, which represent **automated review outcomes** from the doc review pipeline.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Why do some use slashes and others use colons?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The separators follow GitHub label conventions based on their purpose:

Colons (:) = Namespace/category prefixes for organizational grouping:

  • product:v3-monolith, product:telegraf
  • source:auto-detected, source:manual
  • waiting:engineering, approval:codeowner
  • ai:tooling, ci:testing

Slashes (/) = Hierarchical state values (GitHub's native pattern for mutually exclusive states):

  • review/approved, review/changes-requested, review/needs-human

This matches GitHub's own convention (e.g., type/bug, status/in-progress) where slashes indicate "pick one from this set" while colons create organized label families that can be applied together.

@jstirnaman jstirnaman marked this pull request as ready for review March 1, 2026 22:32
@jstirnaman jstirnaman requested a review from a team as a code owner March 1, 2026 22:32
@jstirnaman jstirnaman requested review from sanderson and removed request for a team and sanderson March 1, 2026 22:32
@jstirnaman jstirnaman merged commit 861c0b9 into claude/triage-agent-plan-EOY0u Mar 1, 2026
2 checks passed
@jstirnaman jstirnaman deleted the copilot/sub-pr-6890 branch March 1, 2026 22:37
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