diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index 1b3eaeab3e..bb1e15d6dc 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -394,8 +394,11 @@ in-progress changes do not need to be merged before the move.
 
 To rename a project:
 
-#. Prepare a change to the Puppet configuration which updates
-   projects.yaml/ACLs and jenkins-job-builder for the new name.
+#. Prepare a change to the project-config repo to update things like
+   projects.yaml/ACLs, jenkins-job-builder and gerritbot for the new
+   name. Also add changes to update projects.txt in all branches of
+   the requirements repo and devstack-vm-gate-wrap.sh in the
+   devstack-gate repo if necessary.
 
 #. Stop puppet runs on the puppetmaster to prevent early application
    of configuration changes::