diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index d3a30778ec..1ceb2f363a 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -471,6 +471,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.