From 810dd55d56fbf9d66f7757695b7b04ff89b9dbba Mon Sep 17 00:00:00 2001
From: Alexandra Settle <alexandra.settle@rackspace.com>
Date: Mon, 5 Dec 2016 11:15:42 +0000
Subject: [PATCH] [contrib-guide] Updates project guides with deploy guide
 instructions

Change-Id: I668cd76ecda68d521114f45bae43034f19269cf7
---
 doc/contributor-guide/source/index.rst        |  2 +-
 .../source/project-deploy-guide.rst           | 68 +++++++++++++++++++
 .../source/project-guides.rst                 |  9 +++
 3 files changed, 78 insertions(+), 1 deletion(-)
 create mode 100644 doc/contributor-guide/source/project-deploy-guide.rst
 create mode 100644 doc/contributor-guide/source/project-guides.rst

diff --git a/doc/contributor-guide/source/index.rst b/doc/contributor-guide/source/index.rst
index 07c594ed5f..47f78f5caf 100644
--- a/doc/contributor-guide/source/index.rst
+++ b/doc/contributor-guide/source/index.rst
@@ -19,7 +19,7 @@ Contents
    quickstart.rst
    team-structure.rst
    blueprints-and-specs.rst
-   project-install-guide
+   project-guides
    api-guides.rst
    doc-bugs.rst
    writing-docs.rst
diff --git a/doc/contributor-guide/source/project-deploy-guide.rst b/doc/contributor-guide/source/project-deploy-guide.rst
new file mode 100644
index 0000000000..6c674cba8b
--- /dev/null
+++ b/doc/contributor-guide/source/project-deploy-guide.rst
@@ -0,0 +1,68 @@
+=================
+Deployment guides
+=================
+
+As of the the Newton release, a new method of publishing deployment guides has
+been implemented. This allows each deployment projects to create their own
+deployment guide, based on a standard template, in their own repository.
+These guides are then centrally published to
+`Deployment Guides <http://docs.openstack.org/project-deploy-guide/newton/>`_.
+
+Setting up
+~~~~~~~~~~
+
+#. Install ``cookiecutter``:
+
+   .. code-block:: console
+
+      # pip install cookiecutter
+
+#. Run the Install Guide cookiecutter to create a skeleton for your project:
+
+   .. important::
+
+      The Install Guide cookiecutter is also used for the deployment guides.
+      However, the rest of these instructions are specific to the deployment
+      guide creation.
+
+   .. code-block:: console
+
+      $ cookiecutter https://git.openstack.org/openstack/installguide-cookiecutter.git
+
+   You will be prompted to answer questions to complete the installation.
+   Content is then added to the ``deploy-guide`` directory in the
+   top-level of the project repository.
+
+#. Create a ``tox.ini`` environment for the ``deploy-guide`` in your project
+   repository, using this content:
+
+   .. code-block:: ini
+
+      [testenv:deploy-guide]
+      commands = sphinx-build -a -E -W -d deploy-guide/build/doctrees -b html deploy-guide/source deploy-guide/build/html
+
+
+#. Add your deployment guide content, and test the build locally with ``tox``:
+
+   .. code-block:: console
+
+      $ tox -e deploy-guide
+
+   The local build is in ``deploy-guide/build/html``.
+
+#. Add the Python package ``openstackdocstheme``  to the
+   ``test-requirements.txt`` file. Copy the exact requirement line from the
+   `global file
+   <http://git.openstack.org/cgit/openstack/requirements/tree/global-requirements.txt>`_:
+
+   .. code-block:: none
+
+      openstackdocstheme>=1.5.0  # Apache-2.0
+
+#. Commit the changes to your project repository for review.
+
+To create or update the master index file, create or update the
+``www/project-deploy-guide/RELEASE/index.html`` file at the
+``openstack-manuals`` repository.
+
+For draft (unreleased) version, replace ``RELEASE`` with ``draft``.
diff --git a/doc/contributor-guide/source/project-guides.rst b/doc/contributor-guide/source/project-guides.rst
new file mode 100644
index 0000000000..0a9f2951b1
--- /dev/null
+++ b/doc/contributor-guide/source/project-guides.rst
@@ -0,0 +1,9 @@
+===================
+Project guide setup
+===================
+
+.. toctree::
+   :maxdepth: 2
+
+   project-install-guide.rst
+   project-deploy-guide.rst