feat: add docs link check to CI/CD workflow and update documentation links to be relative

Author: KevinDeBenedetti

.github/workflows/ci-cd.yml

@@ -28,6 +28,7 @@ jobs:
   # shellcheck  → all .sh files at warning severity
   # actionlint  → .github/workflows/
   # bats        → tests/bats/ (env, scripts, kubernetes — offline)
+  # docs-link-check → relative links in docs/ don't escape docs/
   shell-ci:
     uses: KevinDeBenedetti/github-workflows/.github/workflows/ci-shell.yml@main
     with:
@@ -39,6 +40,7 @@ jobs:
       bats-tests-dir: tests/bats/
       bats-submodules: false
       run-docker: false
+      run-docs-link-check: true
 
   # ─── Kubernetes validation + .env.example check ──────────────────────────
   kubernetes:

docs/using-with-infra.md

@@ -168,7 +168,7 @@ KUBECONFIG_CONTEXT=k3s-infra
 
 > ⚠️ `.env` is in `.gitignore`. It is **never committed**. Add `.env.example` with placeholder values instead.
 
-See the [Configuration reference](../configuration.md) for every variable.
+See the [Configuration reference](./configuration.md) for every variable.
 
 ---
 
@@ -198,7 +198,7 @@ make deploy-grafana-secret
 make deploy-monitoring     # Prometheus + Grafana + Loki + Promtail
 ```
 
-See [Getting Started](../getting-started.md) for the full step-by-step walkthrough.
+See [Getting Started](./getting-started.md) for the full step-by-step walkthrough.
 
 ---
 
@@ -366,7 +366,7 @@ make vm-k3s-clean         # tear down when done
 
 The Lima targets read the same `.env` but override environment-specific values (`MASTER_IP=127.0.0.1`, self-signed TLS, NodePort instead of externalIPs).
 
-See the [Local Testing guide](../operations/local-testing.md) for the complete walkthrough.
+See the [Local Testing guide](./operations/local-testing.md) for the complete walkthrough.
 
 ---
 

prek.toml

@@ -46,6 +46,14 @@ hooks = [
   { id = "actionlint" },
 ]
 
+# ─── Docs link safety ────────────────────────────────────────────────────────
+[[repos]]
+repo = "https://github.com/KevinDeBenedetti/github-workflows"
+rev = "bfa0ca537a45e0d359ed3050005fe06a5ea11cbc"
+hooks = [
+  { id = "check-docs-links" },
+]
+
 # ─── Local hooks ────────────────────────────────────────────────────────────
 [[repos]]
 repo = "local"