diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index 1b3eaeab3e..5d741eec48 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -408,8 +408,10 @@ To rename a project:
 
 #. Gracefully stop Zuul on zuul.openstack.org::
 
-     sudo kill -USR1 $(cat /var/run/zuul/zuul.pid)
-     rm -f /var/run/zuul/zuul.pid /var/run/zuul/zuul.lock
+     python /opt/zuul/tools/zuul-changes.py http://zuul.openstack.org gate >gate.sh
+     python /opt/zuul/tools/zuul-changes.py http://zuul.openstack.org check >check.sh
+     sudo invoke-rc.d zuul stop
+     sudo rm -f /var/run/zuul/zuul.pid /var/run/zuul/zuul.lock
 
 #. Stop Gerrit on review.openstack.org::
 
@@ -454,6 +456,8 @@ To rename a project:
 #. Start Zuul on zuul.openstack.org::
 
      sudo invoke-rc.d zuul start
+     sudo bash gate.sh
+     sudo bash check.sh
 
 #. Rename any associated groups whose names may have changed::