Add engineering PRs to review board (#63604)

Copilot-Session: 03e47b55-eabf-42a3-86cc-8d79e869cb1f

Author: heiskr

.github/workflows/reviewers-docs-engineering.yml

@@ -1,10 +1,7 @@
-name: Reviewers - Docs Engineering
+name: Add engineering PRs to review board
 
-# **What it does**: Automatically add reviewers based on paths, but only for the docs-internal repo.
-# And sets the 'engineering' label on the PR. It also edits the PR body to add a template
-# for asking questions for the sake of being confident about the PRs rollout.
-# **Why we have it**: So we can have reviewers automatically without getting open source notifications.
-# **Who does it impact**: Docs team.
+# Routes non-draft engineering PRs to the Docs & Blog Engineering PR Reviews board for triage.
+# Labels each PR, so later pushes skip board work unless the PR reopens.
 
 on:
   pull_request:
@@ -19,9 +16,9 @@ on:
       - '**.tsx'
       - '**.scss'
       - 'src/**'
-      - '!src/**.json' # So that Docs Engineering isn't reviewing automated pipeline data PRs
-      - '!src/**.yml' # So that Docs Engineering isn't reviewing automated pipeline data PRs
-      - '!src/**.sha' # So that Docs Engineering isn't reviewing automated pipeline data PRs
+      - '!src/**.json' # Docs Engineering does not triage automated pipeline data PRs.
+      - '!src/**.yml' # Docs Engineering does not triage automated pipeline data PRs.
+      - '!src/**.sha' # Docs Engineering does not triage automated pipeline data PRs.
       - '.github/**'
       - 'config/**'
       - '.devcontainer/**'
@@ -39,7 +36,8 @@ jobs:
     if: >-
       ${{ github.repository == 'github/docs-internal' &&
           !github.event.pull_request.draft &&
-          !contains(github.event.pull_request.labels.*.name, 'reviewers-docs-engineering') &&
+          (github.event.action == 'reopened' ||
+          !contains(github.event.pull_request.labels.*.name, 'reviewers-docs-engineering')) &&
           !contains(github.event.pull_request.labels.*.name, 'lockfile-churn-only') &&
           github.event.pull_request.head.ref != 'repo-sync' }}
     runs-on: ubuntu-latest
@@ -52,13 +50,13 @@ jobs:
 
       # Detect PRs that only changed package-lock.json (no engineering source files).
       # These are usually cross-platform `npm install` churn from contributors
-      # editing content. We comment with reset instructions instead of pulling in
-      # docs-engineering for review.
+      # editing content. We comment with reset instructions instead of adding
+      # them to the engineering review board.
       #
       # Dependabot is exempt. Its security updates for transitive dependencies
       # change only the lockfile, because the dependency is not in package.json.
       # Those PRs are intentional, so the reset instructions are wrong and
-      # suppressing the review request leaves them with no reviewer at all.
+      # keeping them off the board leaves them without engineering triage.
       - name: Detect lockfile-only churn
         id: detect
         env:
@@ -97,15 +95,19 @@ jobs:
           git push
           ```
 
-          If the lockfile change is intentional, remove the `lockfile-churn-only` label and request docs-engineering review.
+          If the lockfile change is intentional, remove the `lockfile-churn-only` label and push or reopen the PR so this workflow sends it to the engineering review board.
           EOF
           gh pr comment "$PR" --body-file /tmp/lockfile-churn-body.md
           gh pr edit "$PR" --add-label lockfile-churn-only
 
-      - name: Add docs engineering as a reviewer
+      - name: Add PR to board and label
         if: steps.detect.outputs.lockfile_only != 'true'
         env:
           GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_BASE }}
+          REPO: ${{ github.repository }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
         uses: ./.github/actions/retry-command
         with:
-          command: gh pr edit $PR --add-reviewer github/docs-engineering --add-label reviewers-docs-engineering
+          command: >-
+            gh project item-add 25672 --owner github --url "$PR" &&
+            gh api "repos/$REPO/issues/$PR_NUMBER/labels" -f 'labels[]=reviewers-docs-engineering' --silent