diff --git a/docs/writing-docs.md b/docs/writing-docs.md
index 0f93e49..efec301 100644
--- a/docs/writing-docs.md
+++ b/docs/writing-docs.md
@@ -118,6 +118,10 @@ Public READMEs and guides:
 Private homelab docs (ansible, hermes, levkin) may name hosts and IPs.
 Still skip emoji and marketing tone.
 
+Repos under `Gitilia/*` are push mirrors from Gitea. After merging a release or
+public README/docs change, sync and verify from the ansible repo:
+`make github-mirror-sync` then `make github-mirror-health` (see
+`ansible/docs/guides/github-mirrors.md`).
 ## When rewriting existing docs
 
 1. Preserve every real fact (commands, paths, versions, URLs).