diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index 341d672fd4..c3104246a3 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -695,27 +695,26 @@ pupppet repository. To create an actual change that does all of this for
 a single project you will want to do the following:
 
 #. Add a ``modules/openstack_project/files/gerrit/acls/project-name.config``
-   file to the repo. The contents will probably end up looking like::
+   file to the repo. You can refer to the :ref:`project-config` section
+   below if you need more details on writing the project.config file,
+   but contents will probably end up looking like the below block (note
+   that the sections are in alphabetical order and each indentation is
+   8 spaces)::
 
-     [access "refs/*"]
-     	owner = group Administrators
-     [receive]
-     	requireChangeId = true
-     	requireContributorAgreement = true
-     [submit]
-     	mergeContent = true
      [access "refs/heads/*"]
-     	label-Code-Review = -2..+2 group project-name-core
-     	label-Approved = +0..+1 group project-name-core
-     	workInProgress = group project-name-core
+             label-Code-Review = -2..+2 group project-name-core
+             label-Approved = +0..+1 group project-name-core
+             workInProgress = group project-name-core
      [access "refs/heads/milestone-proposed"]
-     	label-Code-Review = -2..+2 group project-name-drivers
-     	label-Approved = +0..+1 group project-name-drivers
+             label-Code-Review = -2..+2 group project-name-drivers
+             label-Approved = +0..+1 group project-name-drivers
      [project]
-     	state = active
-
-You can refer to the :ref:`project-config` section below if you need
-more details on writing the project.config file.
+             state = active
+     [receive]
+             requireChangeId = true
+             requireContributorAgreement = true
+     [submit]
+             mergeContent = true
 
 #. Add a project entry for the project in
    ``openstack-ci-puppet/modules/openstack_project/templates/review.projects.yaml.erb``.::
@@ -723,6 +722,15 @@ more details on writing the project.config file.
      - project: openstack/project-name
        acl_config: /home/gerrit2/acls/project-name.config
 
+#. If there is an existing repo that is being replaced by this new
+   project you can set the upstream value for the project. When an
+   upstream is set, that upstream will be cloned and pushed into Gerrit
+   instead of an empty repository. eg::
+
+     - project: openstack/project-name
+       acl_config: /home/gerrit2/acls/project-name.config
+       upstream: git://github.com/awesumsauce/project-name.git
+
 That is all you need to do. Push the change to gerrit and if necessary
 modify group membership for the groups you configured in the
 ``project.config`` through Launchpad.