ci: add Link Checker summary to GitHub Actions

Author: david-waltermire

.github/workflows/build.yml

@@ -250,6 +250,25 @@ jobs:
         name: html-link-report
         path: html-link-report.md
         retention-days: 5
+    - name: Link Checker Summary
+      if: always()
+      run: |
+        echo "## Link Checker Results" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        if [ -f "html-link-report.md" ]; then
+          # Extract summary stats from the report
+          TOTAL=$(grep -c "^\[" html-link-report.md 2>/dev/null || echo "0")
+          ERRORS=$(grep -c "^\[ERR\]" html-link-report.md 2>/dev/null || echo "0")
+          if [ "$ERRORS" -gt 0 ]; then
+            echo ":x: **Found $ERRORS broken link(s)**" >> $GITHUB_STEP_SUMMARY
+          else
+            echo ":white_check_mark: **All links valid**" >> $GITHUB_STEP_SUMMARY
+          fi
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "See the [html-link-report artifact](../artifacts) for details." >> $GITHUB_STEP_SUMMARY
+        else
+          echo ":warning: No link check report found." >> $GITHUB_STEP_SUMMARY
+        fi
     - name: Create issue if bad links detected
       if: ${{ !cancelled() && steps.linkchecker.outputs.exit_code != 0 && env.INPUT_ISSUE_ON_ERROR == 'true' }}
       uses: peter-evans/create-issue-from-file@fca9117c27cdc29c6c4db3b86c48e4115a786710