Test PR link check settings

Signed-off-by: peppi-lotta <[email protected]>

Author: peppi-lotta

.github/workflows/pr-link-check.yml

@@ -1,12 +1,73 @@
-name: PR Check Links
+name: Check Links In Pull Requests
 
 on:
   pull_request:
     types: [opened, edited, reopened, synchronize, ready_for_review]
+  workflow_call:
+  push:
+    branches:
+      - main
 
-permissions:
-  contents: read
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
 
 jobs:
-  check-pr-links:
-    uses: metal3-io/project-infra/.github/workflows/pr-link-check.yml@main
+  check-links-pr:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Clone repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          fetch-depth: 0
+          ref: ${{github.event.pull_request.head.ref}}
+          repository: ${{github.event.pull_request.head.repo.full_name}}
+
+      - name: Checkout base branch
+        run: git checkout upstream/${{ github.event.pull_request.base.ref }}
+
+      - name: Add upstream remote
+        run: |
+          git remote add upstream https://github.com/metal3-io/metal3-docs.git
+          git fetch upstream
+
+      - name: Get list of changed Markdown files
+        id: changed-files
+        run: |
+          git diff --name-only upstream/"${{ github.event.pull_request.base.ref }}...${{ github.head_ref }}" -- "*.md" > changed-files.txt
+          cat changed-files.txt
+          if [[ -s "changed-files.txt" ]]; then
+            echo "Changed md files found"
+            echo "foundFiles=true" >> "${GITHUB_ENV}"
+          fi
+
+      - name: Switch to PR branch
+        run: git checkout ${{ github.head_ref }}
+
+      - name: Check links in changed files
+        if: env.foundFiles == 'true'
+        uses: lycheeverse/lychee-action@f796c8b7d468feb9b8c0a46da3fac0af6874d374 # v2.2.0
+        with:
+          failIfEmpty: false
+          args: |
+            --no-progress
+            --github-token "${GITHUB_TOKEN}"
+            $(cat changed-files.txt | tr '\n' ' ')
+
+      - name: Provide helpful failure message
+        if: failure()
+        run: |
+          echo "::error::Link check failed! Please review the broken links reported above."
+          echo ""
+          echo "If certain links are valid but fail due to:"
+          echo "- CAPTCHA challenges"
+          echo "- IP blocking"
+          echo "- Authentication requirements"
+          echo "- Rate limiting"
+          echo ""
+          echo "Consider adding them to .lycheeignore to bypass future checks."
+          echo "Format: Add one URL pattern per line"
+          exit 1

docs/user-guide/src/capm3/introduction.md

@@ -1,5 +1,6 @@
 # Kubernetes Cluster API Provider Metal3
 
+TEST
 Kubernetes-native declarative infrastructure for Metal3.
 
 <!-- markdownlint-disable no-inline-html -->

docs/user-guide/src/ipam/introduction.md

@@ -1,5 +1,6 @@
 # IPAM (IP Address Manager)
 
+TEST
 The IPAM project provides a controller to manage static IP address allocations
 in [Cluster API Provider Metal3](https://github.com/metal3-io/cluster-api-provider-metal3/).
 

docs/user-guide/src/version_support.md

@@ -1,5 +1,6 @@
 # Supported release versions
 
+TEST
 The Cluster API Provider Metal3 (CAPM3) team maintains the two most recent minor
 releases; older minor releases are immediately unsupported when a new
 major/minor release is available. Test coverage will be maintained for all