diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index 14622951a9..a326e01591 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -467,6 +467,10 @@ To rename a project:
 
      ssh -p 29418 review.openstack.org gerrit rename-group OLDNAME NEWNAME
 
+#. If renamed/transfered projects using StoryBoard, update the db:
+
+     update projects set name='stackforge/NEW' where name='openstack/OLD';
+
 #. Merge the prepared Puppet configuration change, removing the
    original Jenkins jobs via the Jenkins WebUI later if needed.