link checker - fails PR if links are broken

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

@@ -0,0 +1,26 @@
+name: Markdown Link Checker
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  lychee:
+    name: Check Markdown Links
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install lychee v0.18.1
+        run: |
+          curl -Ls https://github.com/lycheeverse/lychee/releases/download/lychee-v0.18.1/lychee-x86_64-unknown-linux-gnu.tar.gz | tar xz
+          sudo mv lychee /usr/local/bin
+
+      - name: Run lychee on Markdown files with config
+        run: |
+          find . -name "*.md" -print0 | xargs -0 lychee --config .lychee.toml --verbose --no-progress

.lychee.toml

@@ -0,0 +1,13 @@
+# Ignore transient failures on gnu.org (it sometimes refuses connections)
+exclude = [
+  "^https://www.gnu.org/software/make/?$"
+]
+
+# Timeout in seconds
+timeout = 20
+
+# Retry failed links (helpful for flaky sites)
+retry_count = 3
+
+# Accept non-200 status codes (429: rate limits)
+accept = [200, 429]

README.md

@@ -20,9 +20,9 @@ callback mechanism the EPP relies on to make routing decisions to model serving
 workloads currently.
 
 [Kubernetes]:https://kubernetes.io
-[Architecture Documentation]:/docs/architecture.md
+[Architecture Documentation]:docs/architecture.md
 [Gateway API Inference Extension (GIE)]:https://github.com/kubernetes-sigs/gateway-api-inference-extension
-[P/D Disaggregation]:/docs/dp.md
+[P/D Disaggregation]:docs/dp.md
 [Gateway API]:https://github.com/kubernetes-sigs/gateway-api
 [Envoy]:https://github.com/envoyproxy/envoy
 [ext-proc]:https://www.envoyproxy.io/docs/envoy/latest/configuration/http/http_filters/ext_proc_filter
@@ -33,7 +33,7 @@ Contributions are welcome!
 
 For large changes please [create an issue] first describing the change so the
 maintainers can do an assessment, and work on the details with you. See
-[DEVELOPMENT.md](/DEVELOPMENT.md) for details on how to work with the codebase.
+[DEVELOPMENT.md](DEVELOPMENT.md) for details on how to work with the codebase.
 
 Note that in general features should go to the upstream [Gateway API Inference
 Extension (GIE)] project _first_ if applicable. The GIE is a major dependency of