test

.github/workflows/link_checker_workflow.yaml

@@ -32,9 +32,9 @@ jobs:
           restore-keys: cache-lychee-
 
       - name: Link Checker
-        id: lychee-check       
+        id: lychee-check       # Give it an ID to reference later
         uses: lycheeverse/lychee-action@a8c4c7cb88f0c7386610c35eb25108e448569cb0 # v2
-        continue-on-error: true 
+        continue-on-error: true # Let the workflow continue so we can handle the summary order
         with:
           args: >
             --quiet
@@ -46,8 +46,8 @@ jobs:
             docs/
           output: lychee-report.md
           format: markdown
-          fail: true           
-          jobSummary: false    
+          fail: true           # Mark the step outcome as 'failure' internally
+          jobSummary: false    # IMPORTANT: Don't write the report yet!
           debug: false
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -56,13 +56,16 @@ jobs:
         # Run this ONLY if the link checker failed
         if: steps.lychee-check.outcome == 'failure'
         run: |
+          # 1. Write YOUR Note First (Top of Summary)
           echo "## Link Resolution Note" >> $GITHUB_STEP_SUMMARY
           echo "Local links and directory changes work differently on GitHub than on the docsite." >> $GITHUB_STEP_SUMMARY
           echo "You must ensure fixes pass the **GitHub check** and also work with **\`hugo server\`**." >> $GITHUB_STEP_SUMMARY
           echo "See [Link Checking and Fixing with Lychee](https://github.com/googleapis/genai-toolbox/blob/main/DEVELOPER.md#link-checking-and-fixing-with-lychee) for more details." >> $GITHUB_STEP_SUMMARY
           echo "---" >> $GITHUB_STEP_SUMMARY
 
+          # 2. Append the Actual Error Report (Below Note)
           echo "### Broken Links Found" >> $GITHUB_STEP_SUMMARY
           cat ./lychee-report.md >> $GITHUB_STEP_SUMMARY
 
+          # 3. Manually Fail the Job (Since we used continue-on-error above)
           exit 1

.lycheeignore

@@ -23,7 +23,8 @@ https://cloud.dgraph.io/login
 https://dgraph.io/docs
 
 # MySQL Community downloads and main site (often protected by bot mitigation)
-^https?://(.*\.)?mysql\.com/.*
+https://dev.mysql.com/downloads/installer/
+https://www.mysql.com/
 
 # Claude desktop download link
 https://claude.ai/download
@@ -36,8 +37,8 @@ https://dev.mysql.com/doc/refman/8.4/en/sql-prepared-statements.html
 https://dev.mysql.com/doc/refman/8.4/en/user-names.html
 
 # npmjs links can occasionally trigger rate limiting during high-frequency CI builds
-^https?://(www\.)?npmjs\.com/.*
-
+https://www.npmjs.com/package/@toolbox-sdk/core
+https://www.npmjs.com/package/@toolbox-sdk/adk
 https://www.oceanbase.com/
 
 # Ignore social media and blog profiles to reduce external request overhead