fix: add main

Author: btiernay

.github/workflows/link-check.yml

@@ -61,32 +61,46 @@ jobs:
           auth4genai/**/*.md
           auth4genai/**/*.mdx
 
-    # Optional: example of how you might later add main docs checking.
-    # Uncomment and adjust when you want to bring main/ back into scope.
+    # Run Lychee on the main Auth0 Docs content
     #
-    # - name: Run Lychee on main docs
-    #   id: lychee-main
-    #   uses: lycheeverse/lychee-action@v2
-    #   env:
-    #     GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-    #   with:
-    #     args: >
-    #       --verbose
-    #       --no-progress
-    #       --scheme https
-    #       --accept 200..=299,302,429
-    #       main/**/*.md
-    #       main/**/*.mdx
+    # Notes on args:
+    # - --scheme https
+    #     Only check HTTPS links. Other schemes (mailto:, file:, etc) are skipped.
+    # - --accept 200..=299,302,429
+    #     Treat 2xx, 302, and 429 as success. 302 is common for docs redirects,
+    #     429 is rate limiting that we do not want to treat as "broken".
+    # - main/**/*.md / .mdx
+    #     Scope to the legacy/main docs content in this repo.
+    #
+    # As with auth4genai, internal routes and noisy endpoints are excluded
+    # via .lycheeignore at the repo root.
+    - name: Run Lychee on main docs
+      id: lychee-main
+      uses: lycheeverse/lychee-action@v2
+      env:
+        # Used by Lychee for authenticated GitHub requests to reduce rate limiting.
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        args: >
+          --verbose
+          --no-progress
+          --scheme https
+          --accept 200..=299,302,429
+          main/**/*.md
+          main/**/*.mdx
 
     # For now, only warn on failures so you can tune .lycheeignore and fix
     # obvious issues without blocking merges.
     #
     # Once you are happy with the signal/noise ratio, delete this step so that
     # Lychee's non-zero exit code will fail the job.
     - name: Warn on failures instead of failing CI
-      if: steps.lychee-auth4genai.outputs.exit_code != 0
+      if: >
+        (steps.lychee-auth4genai.outputs.exit_code != 0) ||
+        (steps.lychee-main.outputs.exit_code != 0)
       run: |
-        echo "Lychee found broken links in auth4genai docs."
-        echo "Auth4GenAI docs exit code: ${{ steps.lychee-auth4genai.outputs.exit_code }}"
+        echo "Lychee found broken links."
+        echo "Auth4GenAI exit code: ${{ steps.lychee-auth4genai.outputs.exit_code }}"
+        echo "Main docs exit code: ${{ steps.lychee-main.outputs.exit_code }}"
         echo "Check the Lychee step logs above for details."
         exit 0