Merge "Deployment Guide"

deploy-guide/source/advanced-configuration.rst

+..  advanced-configuration.rst:
+.. include:: ../../doc/advanced-configuration.rst

deploy-guide/source/bifrost.rst

+.. bifrost.rst:
+.. include:: ../../doc/bifrost.rst

deploy-guide/source/ceph-guide.rst

+.. ceph-guide.rst:
+.. include:: ../../doc/ceph-guide.rst

deploy-guide/source/cinder-guide-hnas.rst

+.. cinder-guide-hnas.rst:
+.. include:: ../../doc/cinder-guide-hnas.rst

deploy-guide/source/cinder-guide.rst

+.. cinder-guide.rst:
+.. include:: ../../doc/cinder-guide.rst

deploy-guide/source/deployment-philosophy.rst

+.. deployment-philosophy.rst:
+.. include:: ../../doc/deployment-philosophy.rst

deploy-guide/source/designate-guide.rst

+.. designate-guide.rst:
+.. include:: ../../doc/designate-guide.rst

deploy-guide/source/external-ceph-guide.rst

+.. external-ceph-guide.rst:
+.. include:: ../../doc/external-ceph-guide.rst

deploy-guide/source/get-started.rst

-Kolla deployment guide
-======================
-
-.. Populate these files with the Kolla Deployment guide -JR.

deploy-guide/source/index.rst

+..
+      Copyright 2014-2015 OpenStack Foundation
+      All Rights Reserved.
+
+      Licensed under the Apache License, Version 2.0 (the "License"); you may
+      not use this file except in compliance with the License. You may obtain
+      a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+      Unless required by applicable law or agreed to in writing, software
+      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+      License for the specific language governing permissions and limitations
+      under the License.
+
 ======================
 Kolla Deployment Guide
 ======================
 
-.. toctree::
-   :maxdepth: 2
+Kolla's Mission
+===============
+
+Kolla provides Docker containers and Ansible playbooks to meet Kolla's mission.
+Kolla's mission is to provide production-ready containers and deployment tools
+for operating OpenStack clouds.
 
-   get-started.rst
-   next-steps.rst
+Kolla is highly opinionated out of the box, but allows for complete
+customization. This permits operators with minimal experience to deploy
+OpenStack quickly and as experience grows modify the OpenStack configuration to
+suit the operator's exact requirements.
 
-The Kolla service provides...
+.. toctree::
+   :maxdepth: 1
 
-This chapter assumes a working setup of OpenStack following the
-`OpenStack Installation Tutorial <http://docs.openstack.org/#install-guides>`_.
+   kolla-ansible-index.rst

deploy-guide/source/ironic-guide.rst

+.. ironic-guide.rst:
+.. include:: ../../doc/ironic-guide.rst

deploy-guide/source/kibana-guide.rst

+.. kibana-guide.rst:
+.. include:: ../../doc/kibana-guide.rst

deploy-guide/source/kolla-ansible-index.rst

+
+.. kolla-ansible-index.rst:
+
+Kolla-Ansible
+=============
+
+Overview
+--------
+
+.. toctree::
+   :maxdepth: 2
+
+   deployment-philosophy.rst
+   production-architecture-guide.rst
+   quickstart.rst
+   multinode.rst
+   advanced-configuration.rst
+   operating-kolla.rst
+   security.rst
+   nova-fake-driver.rst
+   troubleshooting.rst
+
+Services
+--------
+
+.. toctree::
+   :maxdepth: 2
+
+   bifrost.rst
+   ceph-guide.rst
+   cinder-guide.rst
+   cinder-guide-hnas.rst
+   designate-guide.rst
+   external-ceph-guide.rst
+   ironic-guide.rst
+   kibana-guide.rst
+   kuryr-guide.rst
+   manila-guide.rst
+   manila-hnas-guide.rst
+   networking-guide.rst
+   swift-guide.rst
+
+.. toctree::
+   :hidden:
+
+   vagrant-dev-env.rst

deploy-guide/source/kuryr-guide.rst

+.. kuryr-guide.rst:
+.. include:: ../../doc/kuryr-guide.rst

deploy-guide/source/manila-guide.rst

+.. manila-guide.rst:
+.. include:: ../../doc/manila-guide.rst

deploy-guide/source/manila-hnas-guide.rst

+.. manila-hnas-guide.rst:
+.. include:: ../../doc/manila-hnas-guide.rst

deploy-guide/source/multinode.rst

+.. multinode.rst:
+.. include:: ../../doc/multinode.rst

deploy-guide/source/networking-guide.rst

+.. networking-guide.rst:
+.. include:: ../../doc/networking-guide.rst

deploy-guide/source/next-steps.rst

-Kolla deployment guide next steps
-=================================
-
-.. Populate these files with the Kolla Deployment guide -JR.

deploy-guide/source/nova-fake-driver.rst

+.. nova-fake-driver.rst:
+.. include:: ../../doc/nova-fake-driver.rst