diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index ac0feed04f..c316bcf37f 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -131,6 +131,26 @@ keys. e.g.::
   sudo su - gerrit2
   ssh github.com
 
+Troubleshooting
+---------------
+When creating a new project, there can be times where the :ref:`jeepyb`
+automation to create the GitHub project can fail, and leave the project
+improperly configured.
+This can cause replication to GitHub to fail. The project in GitHub will
+be created, but will appear empty. When trying replication from Gerrit,
+it will show a `Permission denied` error when trying to push content.
+To solve that, following steps are needed:
+
+ #. Login into github.com, using openstack-project-creator user.
+
+ #. Navigate to the failed repository, and enter on Settings > Collaborators
+ & teams option.
+
+ #. Add Gerrit as Team member to that project.
+
+After the team has been added, project will start replicating successfully
+to GitHub.
+
 
 Auto Review Expiry
 ==================