diff --git a/doc/source/creators.rst b/doc/source/creators.rst
index f5dfe1c..61ae327 100644
--- a/doc/source/creators.rst
+++ b/doc/source/creators.rst
@@ -194,6 +194,13 @@ Add the project to the master projects list
        description: Latest and greatest cloud stuff.
        upstream: https://github.com/awesumsauce/<projectname>.git
 
+   .. warning::
+
+      When import a project from an upstream, it's important that you ensure no
+      Zuul configuration is included in the repository.  The import process will
+      also import all of the branches, so please make sure that you remove any
+      branches you don't want imported.
+
    .. note::
 
       If you do not configure the upstream source here and get the project