Skip check for 502, 522 errors

Author: eshanrnh

.github/lychee.toml

@@ -31,10 +31,17 @@ timeout = 10
 retry_wait_time = 1
 
 # Accept more status codes (follow redirects automatically)
-accept = ["200..=204", "301..=308", "429", "502", "522"]
+# Note: 522 and 502 are server errors, not broken links
+accept = [
+  "200..=204", 
+  "301..=308", 
+  "429",
+  "502",  # Bad Gateway
+  "522"   # Connection timed out (Cloudflare)
+]
 
-# Avoid false fragment errors
-include_fragments = false  
+# Don't check fragments/anchors - they cause false positives
+include_fragments = false
 
 # Only test links with the given schemes (e.g. https and http)
 scheme = ["https", "http"]
@@ -53,14 +60,20 @@ exclude = [
   '^https?://localhost',
   '^https?://127\\.0\\.0\\.1',
   '^https://www\\.linkedin\\.com',
-  # Exclude all issues.umbraco.org links (they're unreliable)
-  'issues\\.umbraco\\.org',
+  
+  # Exclude all issues.umbraco.org - unreliable and often returns 522
+  'http://issues\\.umbraco\\.org',
+  'https://issues\\.umbraco\\.org',
+  
   # Exclude umbraco.com blog posts that return errors
-  'umbraco\\.com/blog/',
+  'https://umbraco\\.com/blog/',
+  
   # Exclude web archive links
   'web\\.archive\\.org/web/',
-  # Exclude anchor links to version-specific sections (e.g., #umbraco-14)
-  '#umbraco-[0-9]+',
+  
+  # Exclude internal links with version anchors
+  'version-specific#umbraco-',
+  'README\\.md#umbraco-[0-9]',
 ]
 
 # Exclude these filesystem paths from getting checked.

.github/workflows/check-broken-pr-links.yml

@@ -64,6 +64,9 @@ jobs:
             }
 
             /\[ERROR\]/ {
+              # Skip anchor errors for #umbraco-[number] patterns
+              if ($0 ~ /#umbraco-[0-9]+/) next
+              
               msg = $0
               sub(/^- \[ \] /, "", msg)
               sub(/^\[ERROR\] /, "", msg)
@@ -91,6 +94,30 @@ jobs:
               next
             }
 
+            /\[522\]/ {
+              # Skip 522 errors from issues.umbraco.org
+              if ($0 ~ /issues\.umbraco\.org/) next
+              
+              msg = $0
+              sub(/^- \[ \] /, "", msg)
+              sub(/^\[522\] /, "", msg)
+              gsub(/\|/, "\\|", msg)
+              print "\n⚠ Server error (522) → " msg "\n" >> "lychee/comment.md"
+              next
+            }
+
+            /\[502\]/ {
+              # Skip 502 errors from umbraco.com
+              if ($0 ~ /umbraco\.com/) next
+              
+              msg = $0
+              sub(/^- \[ \] /, "", msg)
+              sub(/^\[502\] /, "", msg)
+              gsub(/\|/, "\\|", msg)
+              print "\n⚠ Server error (502) → " msg "\n" >> "lychee/comment.md"
+              next
+            }
+
             /Timeout/ && !/Timeouts/ {
               msg = $0
               sub(/^- \[ \] /, "", msg)
@@ -131,4 +158,4 @@ jobs:
         if: steps.format-report.outputs.has_content == 'true'
         run: |
           echo "❌ Broken links detected. Please review the PR comment for details."
-          exit 1
+          exit 1