Add workflow to create docs tracking issues for breaking changes

Co-authored-by: danroth27 <[email protected]>

Author: Copilot

.github/workflows/create-docs-issue.yaml

@@ -0,0 +1,80 @@
+name: "Create Docs Issue for Breaking Change"
+on: 
+  issues:
+    types: [opened, labeled]
+
+jobs:
+  create-docs-issue:
+    runs-on: ubuntu-latest
+    # Only run if the issue has the "Breaking change" label
+    if: contains(github.event.issue.labels.*.name, 'Breaking change')
+    steps:
+      - name: Create issue in aspnetcore.docs
+        uses: actions/github-script@v7
+        with:
+          # Use a token with cross-repository permissions
+          # The GITHUB_TOKEN doesn't have permission to create issues in other repos
+          # A PAT with repo scope should be stored as a secret (e.g., DOCS_ISSUE_TOKEN)
+          github-token: ${{ secrets.DOCS_ISSUE_TOKEN || secrets.GITHUB_TOKEN }}
+          script: |
+            const issueTitle = context.payload.issue.title;
+            const issueNumber = context.payload.issue.number;
+            const issueUrl = context.payload.issue.html_url;
+            const issueBody = context.payload.issue.body || '';
+            
+            // Check if we've already created a docs issue for this breaking change
+            // by looking for existing comments from the bot
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber
+            });
+            
+            const docsIssueAlreadyCreated = comments.data.some(comment => 
+              comment.user.type === 'Bot' && 
+              comment.body.includes('A documentation tracking issue has been created')
+            );
+            
+            if (docsIssueAlreadyCreated) {
+              console.log('Docs issue already created for this breaking change. Skipping.');
+              return;
+            }
+            
+            // Create the issue body for the docs repo
+            const docsIssueBody = `This issue tracks adding documentation for a breaking change announced in aspnet/Announcements.
+
+**Breaking Change Issue:** ${issueUrl}
+**Issue Number:** #${issueNumber}
+**Title:** ${issueTitle}
+
+---
+
+${issueBody}
+
+---
+
+Please add documentation for this breaking change to the ASP.NET Core documentation.`;
+            
+            // Create the issue in dotnet/aspnetcore.docs
+            try {
+              const newIssue = await github.rest.issues.create({
+                owner: 'dotnet',
+                repo: 'AspNetCore.Docs',
+                title: `[Breaking Change] ${issueTitle}`,
+                body: docsIssueBody,
+                labels: ['breaking-change', 'aspnet/Announcements']
+              });
+              
+              console.log(`Created issue: ${newIssue.data.html_url}`);
+              
+              // Comment on the original issue with a link to the docs issue
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issueNumber,
+                body: `📝 A documentation tracking issue has been created: ${newIssue.data.html_url}`
+              });
+            } catch (error) {
+              console.error('Error creating docs issue:', error);
+              core.setFailed(`Failed to create docs issue: ${error.message}`);
+            }