diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md
index a2dc55ca..58d2769e 100644
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@ -151,6 +151,9 @@ ufw default deny incoming && ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 4
 apt install caddy
 
 # Use the Caddyfile from the repo (replace path with the runner's clone target)
+# CI DEPENDENCY: the nightly and release workflows run `systemctl reload caddy` to
+# pick up committed Caddyfile changes. They find the file via this symlink — if it
+# is absent or points elsewhere, the reload succeeds but serves stale config.
 ln -sf /opt/familienarchiv/infra/caddy/Caddyfile /etc/caddy/Caddyfile
 systemctl reload caddy