diff --git a/doc/source/sysadmin.rst b/doc/source/sysadmin.rst
index 06759b3ff6..b93cc3ff2b 100644
--- a/doc/source/sysadmin.rst
+++ b/doc/source/sysadmin.rst
@@ -467,6 +467,13 @@ attempting to run it during the regular zuul jobs. If you choose to run
 puppet manually on a host, take care to ensure that it has not been disabled
 at the bridge level first.
 
+If you need to pause all execution of ansible playbooks by Zuul you can
+run the utility script ``disable-ansible``. The script touches the file
+``/home/zuul/DISABLE-ANSIBLE`` on bridge.openstack.org. Doing
+this forces the Zuul jobs that run ansible for us to wait until that file is
+removed. This acts like a global pause. The script exists to prevent admins
+from misspelling the name of the file and is recommended.
+
 Examples
 --------