--- a/hg-web/README.md	Sun Aug 02 14:42:01 2026 -0700
+++ b/hg-web/README.md	Sun Aug 02 16:31:44 2026 -0700
@@ -217,6 +217,25 @@
 release root, active path, health URL, user, and group can be overridden with
 environment variables.
 
+## Publishing
+
+Push committed Mercurial changes to the configured server:
+
+```bash
+hg push
+```
+
+Then update and deploy on the server:
+
+```bash
+ssh -t [email protected] \
+  'cd ~/zenbu && hg update default && bazel run //hg-web:deploy'
+```
+
+The SSH key may prompt for its passphrase. `//hg-web:deploy` builds the release
+bundle through Bazel before running the atomic promotion, health check, and
+rollback workflow.
+
 ## Forge capability tree
 
 ```text