diff --git a/docs/README.md b/docs/README.md
index 3acbfb868..d4ceff169 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,6 +4,10 @@ Internal documentation for engineers and agents working in the Compass repo.
 
 Start with [AGENTS.md](../AGENTS.md) for repo rules and command defaults. Use this index for codebase shape, subsystem behavior, and acceptance runbooks.
 
+## How docs get published
+
+Markdown files in this `docs/` directory are automatically mirrored to [docs.compasscalendar.com](https://docs.compasscalendar.com). A GitHub Action detects any push to `main` that touches `docs/**` and syncs the changes to the doc site. Just edit any of the markdown in `docs/` and the doc site will update itself upon merge.
+
 ## Start Here
 
 - [Repo Architecture](./architecture/repo-architecture.md)