Check for broken links

Signed-off-by: David Gageot <david.gageot@docker.com>

Author: dgageot

Taskfile.yml

@@ -98,6 +98,40 @@ tasks:
         docker-agent-docs \
         jekyll serve --host 0.0.0.0 --config _config.yml,_config.dev.yml --livereload
 
+  docs-check-links:
+    desc: Build the documentation site and check for broken links
+    dir: docs
+    cmd: |
+      cleanup() {
+        docker rm -f docs-linkcheck 2>/dev/null
+        docker network rm docs-linkcheck-net 2>/dev/null
+      }
+      trap cleanup EXIT
+
+      docker build -t docker-agent-docs . && \
+      docker network create docs-linkcheck-net && \
+      docker run -d --rm \
+        --name docs-linkcheck \
+        --network docs-linkcheck-net \
+        -v "{{.TASKFILE_DIR}}/docs:/srv/jekyll" \
+        docker-agent-docs \
+        jekyll serve --host 0.0.0.0 --config _config.yml,_config.dev.yml && \
+      echo 'Waiting for Jekyll to start...' && \
+      for i in $(seq 1 30); do \
+        docker run --rm --network docs-linkcheck-net curlimages/curl -sf http://docs-linkcheck:4000/ > /dev/null 2>&1 && break; \
+        sleep 2; \
+      done && \
+      docker run --rm \
+        --network docs-linkcheck-net \
+        raviqqe/muffet \
+        --buffer-size 16384 \
+        --exclude 'fonts.googleapis.com' \
+        --exclude 'fonts.gstatic.com' \
+        --exclude 'console.mistral.ai' \
+        --exclude 'console.x.ai' \
+        --rate-limit 20 \
+        http://docs-linkcheck:4000/
+
   record-demo:
     desc: Record demo gif
     cmd: vhs ./docs/recordings/demo.tape

docs/community/contributing/index.md

@@ -15,7 +15,7 @@ _docker-agent is open source. Here's how to set up your development environment
 - [Go 1.26](https://go.dev/dl/) or higher
 - API key(s) for your chosen AI provider
 - [Task 3.44](https://taskfile.dev/installation/) or higher
-- [golangci-lint](https://golangci-lint.run/docs/welcome/install/#binaries)
+- [golangci-lint](https://golangci-lint.run/docs/welcome/install/local/)
 
 <div class="callout callout-info">
 <div class="callout-title">ℹ️ Platform Support

docs/features/a2a/index.md

@@ -10,7 +10,7 @@ _Expose docker-agent agents via Google's Agent-to-Agent (A2A) protocol for inter
 
 ## Overview
 
-The `docker agent serve a2a` command starts an A2A server that exposes your agents using the [A2A protocol](https://google.github.io/A2A/). This enables communication between Docker Agent and other agent frameworks that support A2A.
+The `docker agent serve a2a` command starts an A2A server that exposes your agents using the [A2A protocol](https://a2a-protocol.org/latest/). This enables communication between Docker Agent and other agent frameworks that support A2A.
 
 <div class="callout callout-warning">
 <div class="callout-title">⚠️ Early support

docs/getting-started/installation/index.md

@@ -73,7 +73,7 @@ For the latest features, or to contribute, build from source:
 
 - [Go 1.26](https://go.dev/dl/) or higher
 - [Task 3.44](https://taskfile.dev/installation/) or higher (build tool)
-- [golangci-lint](https://golangci-lint.run/docs/welcome/install/#binaries) (for linting)
+- [golangci-lint](https://golangci-lint.run/docs/welcome/install/local/) (for linting)
 
 ```bash
 # Clone the repository