Re-enable link checker workflows; gate PR checker on check-links label (#59715)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: heiskr

.github/workflows/link-check-external.yml

@@ -1,7 +1,4 @@
-name: Check External Links
-
-# Runs weekly (Wednesday) at 16:20 UTC
-# Validates external URLs in content files
+name: 'Link Check: External'
 
 on:
   schedule:
@@ -56,6 +53,15 @@ jobs:
         run: |
           if [ -f "artifacts/external-link-report.md" ]; then
             echo "has_report=true" >> $GITHUB_OUTPUT
+            # Prepend disclaimer banner
+            tmp=$(mktemp)
+            {
+              echo "> [!NOTE]"
+              echo "> **No action needed right now.** The link checker is being actively worked on and may produce false positives. You can safely ignore this report for now. We'll let you know when it's reliable."
+              echo ""
+              cat "artifacts/external-link-report.md"
+            } > "$tmp"
+            mv "$tmp" "artifacts/external-link-report.md"
           else
             echo "has_report=false" >> $GITHUB_OUTPUT
             echo "No broken link report generated - all links valid!"

…ows/check-broken-links-github-github.yml …b/workflows/link-check-github-github.yml.github/workflows/check-broken-links-github-github.yml renamed to .github/workflows/link-check-github-github.yml .github/workflows/check-broken-links-github-github.yml renamed to .github/workflows/link-check-github-github.yml

@@ -1,4 +1,4 @@
-name: Check Broken Docs Links in github/github
+name: 'Link Check: github/github'
 
 # **What it does**: This checks for any broken docs.github.com links in github/github
 # **Why we have it**: Make sure all docs in github/github are up to date

.github/workflows/link-check-internal.yml

@@ -1,8 +1,4 @@
-name: Check Internal Links
-
-# Runs weekly (Tuesday) at 16:20 UTC
-# On schedule: checks English free-pro-team and latest enterprise-server
-# On workflow_dispatch: run any version/language combo
+name: 'Link Check: Internal'
 
 on:
   schedule:
@@ -129,6 +125,9 @@ jobs:
             # Combine all markdown reports
             echo "# Internal Links Report" > combined-report.md
             echo "" >> combined-report.md
+            echo "> [!NOTE]" >> combined-report.md
+            echo "> **No action needed right now.** The link checker is being actively worked on and may produce false positives. You can safely ignore this report for now. We'll let you know when it's reliable." >> combined-report.md
+            echo "" >> combined-report.md
             echo "Generated: $(date -u +'%Y-%m-%d %H:%M UTC')" >> combined-report.md
             echo "[Action run](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})" >> combined-report.md
             echo "" >> combined-report.md

.github/workflows/link-check-on-pr.yml

@@ -1,13 +1,14 @@
-name: 'Link Checker: On PR'
+name: 'Link Check: On PR'
 
 # **What it does**: Checks internal links in changed content files.
 # **Why we have it**: To catch broken links before they're merged.
 # **Who does it impact**: Docs content.
 
 on:
   workflow_dispatch:
-  merge_group:
+  # merge_group:
   pull_request:
+    types: [labeled, opened, synchronize, reopened]
 
 permissions:
   contents: read
@@ -23,7 +24,9 @@ jobs:
   check-links:
     name: Check links
     runs-on: ubuntu-latest
-    if: github.repository == 'github/docs-internal' || github.repository == 'github/docs'
+    if: |
+      (github.repository == 'github/docs-internal' || github.repository == 'github/docs') &&
+      (github.event_name == 'workflow_dispatch' || contains(github.event.pull_request.labels.*.name, 'check-links'))
     steps:
       - name: Checkout
         uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1

src/links/lib/link-report.ts

@@ -131,6 +131,9 @@ ${errors
 
     return `## 🔗 Link Check Results
 
+> [!NOTE]
+> **This check is being actively worked on** and may produce false positives. If something looks wrong, you can safely ignore it for now.
+
 ${errorSection}${warningSection}${detailsLink}
 <!-- link-checker-pr-comment -->`
   },