Revert "Build a more organized doc structure"

Our philosophy document is one of our most important documents
in he documentation repository.  I appreciate in general the notion
of reorganizing many of our docs, but this one should be left alone
and possibly protected by a roll-call vote in the future.

This reverts commit aa517c4bf9.

Change-Id: Ic17861e823095a1891ac25ddaf429b66e352e30e
This commit is contained in:
Steven Dake 2016-09-12 12:12:34 -07:00
parent e1b9608733
commit 28b80a08cf
4 changed files with 25 additions and 47 deletions

View File

@ -1,8 +1,26 @@
.. _templating:
.. _deployment-philosophy:
================
Kolla Templating
================
=============================
Kolla's Deployment Philosophy
=============================
Overview
========
Kolla has an objective to replace the inflexible, painful, resource-intensive
deployment process of OpenStack with a flexible, painless, inexpensive
deployment process. Often to deploy OpenStack at the 100+ node scale small
businesses may require means building a team of OpenStack professionals to
maintain and manage the OpenStack deployment. Finding people experienced in
OpenStack deployment is very difficult and expensive, resulting in a big
barrier for OpenStack adoption. Kolla seeks to remedy this set of problems by
simplifying the deployment process while enabling flexible deployment models.
Kolla is a highly opinionated deployment tool out of the box. This permits
Kolla to be deployable with the simple configuration of three key/value pairs.
As an operator's experience with OpenStack grows and the desire to customize
OpenStack services increases, Kolla offers full capability to override every
OpenStack service configuration option in the deployment.
Why not Template Customization?
===============================

View File

@ -1,40 +0,0 @@
.. _deployment-philosophy:
=============================
Kolla's Deployment Philosophy
=============================
Overview
========
Kolla has an objective to replace the inflexible, painful, resource-intensive
deployment process of OpenStack with a flexible, painless, inexpensive
deployment process. Often to deploy OpenStack at the 100+ node scale small
businesses may require means building a team of OpenStack professionals to
maintain and manage the OpenStack deployment. Finding people experienced in
OpenStack deployment is very difficult and expensive, resulting in a big
barrier for OpenStack adoption. Kolla seeks to remedy this set of problems by
simplifying the deployment process but enabling flexible deployment models.
Kolla is a highly opinionated deployment tool out of the box. This permits
Kolla to be deployable with the simple configuration of three key/value pairs.
As an operator's experience with OpenStack grows and the desire to customize
OpenStack services increases, Kolla offers full capability to override every
OpenStack service configuration option in the deployment.
Templating and Customization Philosophy
=======================================
To read up on the Kolla communities template philosphy go to the
:doc:`templating` doc.
Architecture
============
#TODO: Link an image showing the architecture
.. toctree::
:hidden:
templating

View File

@ -34,14 +34,14 @@ Kolla Overview
==============
.. toctree::
:maxdepth: 2
:maxdepth: 1
deployment-philosophy/deployment-philosophy
architecture-guide
deployment-philosophy
quickstart
multinode
image-building
advanced-configuration
architecture-guide
operating-kolla
security