Focus link checker on auth4genai docs only

Changes:
- Disable main docs checking (commented out for now)
- Only check auth4genai docs against https://auth0.com/ai/docs
- Accept 429 (rate limit) as valid status code
- Simplified failure check to only auth4genai output

This reduces noise and focuses on the actively developed
auth4genai documentation. Main docs can be re-enabled later.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: btiernay

.github/workflows/link-check.yml

@@ -48,21 +48,21 @@ jobs:
       #     npm ci
       #     npm run docs:build
 
-      - name: Check main docs links
-        id: lychee-main
-        uses: lycheeverse/lychee-action@v2
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          args: >
-            --verbose
-            --no-progress
-            --base-url ${{ inputs.base_url || 'https://auth0.com' }}
-            --accept 200..=299,302
-            --exclude-path '../LICENSE'
-            main/**/*.md
-            main/**/*.mdx
-          # Main docs: paths like /docs/... resolve to https://auth0.com/docs/...
+      # TODO: Re-enable main docs checking later
+      # - name: Check main docs links
+      #   id: lychee-main
+      #   uses: lycheeverse/lychee-action@v2
+      #   env:
+      #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      #   with:
+      #     args: >
+      #       --verbose
+      #       --no-progress
+      #       --base-url ${{ inputs.base_url || 'https://auth0.com' }}
+      #       --accept 200..=299,302,429
+      #       --exclude-path '../LICENSE'
+      #       main/**/*.md
+      #       main/**/*.mdx
 
       - name: Check auth4genai docs links
         id: lychee-auth4genai
@@ -74,19 +74,19 @@ jobs:
             --verbose
             --no-progress
             --base-url https://auth0.com/ai/docs
-            --accept 200..=299,302
+            --accept 200..=299,302,429
             --exclude-path '.vale'
             auth4genai/**/*.md
             auth4genai/**/*.mdx
           # Auth4GenAI docs: paths like /intro/... resolve to https://auth0.com/ai/docs/intro/...
+          # Accept 429 to handle rate limiting on auth0.com
 
       # For now this only warns so it does not block merges while you tune ignores.
       # Once the noise is under control, delete this step so Lychee failures break CI.
       - name: Warn on failures instead of failing CI
-        if: steps.lychee-main.outputs.exit_code != 0 || steps.lychee-auth4genai.outputs.exit_code != 0
+        if: steps.lychee-auth4genai.outputs.exit_code != 0
         run: |
           echo "Lychee found broken links."
-          echo "Main docs exit code: ${{ steps.lychee-main.outputs.exit_code }}"
           echo "Auth4GenAI docs exit code: ${{ steps.lychee-auth4genai.outputs.exit_code }}"
           echo "Check the Lychee step logs above for details."
           exit 0