From d15c1d8e4a1bb9d49bb0e9e06c46c87a6a330b9f Mon Sep 17 00:00:00 2001
From: Anita Kuno <anteaya@anteaya.info>
Date: Fri, 28 Mar 2014 12:00:28 -0400
Subject: [PATCH] Adds sanitised stackforge source repo requirement to docs

Stackforge creation sometimes includes source repos with crufty
branches. Cleaning these branches in stackforge requires -infra
core intervention. Sanitising them prior to seeding the stackforge
repo is easier than cleaning them afterward.

Change-Id: I0d71c9e252913dc781632988df95cc79c626d2b4
---
 doc/source/stackforge.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/source/stackforge.rst b/doc/source/stackforge.rst
index c6aae6a92b..a93019d3f4 100644
--- a/doc/source/stackforge.rst
+++ b/doc/source/stackforge.rst
@@ -64,6 +64,11 @@ repository which can be used to preseed Gerrit with an initial commit
 history. Both of these are optional. Note that the current tools
 assume that the upstream repo will have a master branch.
 
+Note: Ensure the source repo has been evaluated and only required branches
+and tags remain when it seeds the stackforge repo. Cleaning up a repo of
+unnecessary branches and tags after the merge requires an openstack-infra
+core member to do so.
+
 The next step is to add a Gerrit ACL config file. Edit
 ``modules/openstack_project/files/gerrit/acls/stackforge/project-name.config``
 and make it look like::