Refine GitHub Actions workflow to ensure link checks report errors correctly by adding failure handling for absolute and relative link checks

Author: strickvl

.github/workflows/check-links.yml

@@ -31,10 +31,13 @@ jobs:
         id: check-absolute
         run: |
           # Only check absolute links (http/https), not relative links
-          python docs/link_checker.py --dir docs/book --substring "http" --validate-links --timeout 15 --ci-mode
+          python docs/link_checker.py --dir docs/book --substring "http" --validate-links --timeout 15 --ci-mode || true
           echo "exit_code=$?" >> $GITHUB_OUTPUT
-        # Continue on error so both checks can run to completion
-        continue-on-error: true
+      - name: Check for failures
+        if: steps.check-absolute.outputs.exit_code != '0'
+        run: |
+          echo "::error::Absolute links check failed. Please check the job logs for details."
+          exit 1
   check-relative-links:
     if: github.event.pull_request.draft == false
     runs-on: ubuntu-latest
@@ -51,10 +54,13 @@ jobs:
         id: check-relative
         run: |
           # Check if relative links resolve within the repository
-          python scripts/check_relative_links.py --dir docs/book
+          python scripts/check_relative_links.py --dir docs/book || true
           echo "exit_code=$?" >> $GITHUB_OUTPUT
-        # Continue on error so both checks can run to completion
-        continue-on-error: true
+      - name: Check for failures
+        if: steps.check-relative.outputs.exit_code != '0'
+        run: |
+          echo "::error::Relative links check failed. Please check the job logs for details."
+          exit 1
   summary:
     needs: [check-absolute-links, check-relative-links]
     if: always() && github.event.pull_request.draft == false