Add automation to create docs tracking issues for breaking changes

[Copilot]

Automates creation of documentation tracking issues in dotnet/AspNetCore.Docs when breaking change issues are opened or labeled in this repository.

Implementation

New workflow: .github/workflows/create-docs-issue.yaml

• Triggers on issues.opened and issues.labeled events with "Breaking change" label
• Creates issue in docs repo with:
  • Title: [Breaking Change] <original title>
  • Body: Link to source issue, full context
  • Labels: breaking-change, aspnet/Announcements
• Posts comment on source issue with link to docs issue

Duplicate Prevention

Multi-layer detection to handle race conditions and partial failures:

• Checks for existing bot comments in source issue
• Searches docs repo by title before creating
• Concurrency control keyed on issue number

Error Handling

Separate try-catch blocks for each operation:

• Comment listing failures → proceed with search
• Search failures → proceed with creation (fail open to avoid missing docs)
• Comment posting failures → don't fail workflow (docs issue already created)
• Permission errors → explicit message about DOCS_ISSUE_TOKEN requirement

Setup Required

Configure DOCS_ISSUE_TOKEN repository secret with repo scope for cross-repository issue creation. Falls back to GITHUB_TOKEN but will fail with clear error message.

Security

Explicit minimal permissions: issues: write, contents: read

Original prompt

Add automation that is triggered when a breaking change issue is opened in this repo. The automation should create an issue in the dotnet/aspnetcore.docs repo that tracks adding documentation for the breaking change.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.