Re-structure docs

Change-Id: I10ee0df7c185baf237eb367aceba805e0844e810

doc/admin_api/index.rst

@@ -1,3 +1,5 @@
+.. _libra-admin-api:
+
 Libra Admin API Server
 ======================
 

doc/api/index.rst

@@ -1,3 +1,5 @@
+.. _libra-api:
+
 Libra API Server
 ================
 

doc/architecture/index.rst

@@ -0,0 +1,9 @@
+.. _architecture:
+
+Architecture
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   logical

doc/architecture/logical.rst

@@ -1,23 +1,21 @@
-Introduction
-============
+=============
+Logical architecture
+=============
 
-Libra is a Load Balancer as a Service (LBaaS) system originally designed by
-Hewlett-Packard Cloud Services.  It consists of five core components
-required to get LBaaS working:
+See information for each component for more information.
 
-* A node pool manager to keep a warm spare pool of load balancers ready
-* A node worker to asynchronously communicate to the API server
-* A monitoring system for the load balancers
-* A customer API server
-* An administrative API server
+* :ref:`libra-pool-mgr` - A node pool manager to keep a warm spare pool of load balancers ready
+* :ref:`libra-worker` - A node worker to asynchronously communicate to the API server
+* :ref:`libra-api` - A customer API server
+* :ref:`libra-admin-api` - An administrative API server
 
 The API server is based on a modified version of the `Atlas API specification
 <https://wiki.openstack.org/wiki/Atlas-LB>`_.
 
-Layout
-------
+High level overview
+-------------------
 
-.. image:: libralayout.png
+.. image:: /img/libralayout.png
 
 Here you can see that the pool manager spins up the required Nova nodes with
 the load balancer image.  It then hands the details of these nodes over to the

doc/getting-started.rst

@@ -0,0 +1,11 @@
+===============
+Getting started
+===============
+
+Libra is a system to provide LoadBalancing as a Service on top of
+various platforms. It is comprised of four components :ref:`libra-api`,
+:ref:`libra-admin-api`, :ref:`libra-pool-mgr` and :ref:`libra-worker`,
+supported by a few other open source components. For more information see
+:doc:`architecture/index`.
+
+

doc/index.rst

@@ -2,9 +2,10 @@ Load Balancer as a Service Device Tools
 =======================================
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
 
-   introduction
+   getting-started
+   architecture/index
    worker/index
    pool_mgm/index
    api/index

doc/pool_mgm/index.rst

@@ -1,3 +1,5 @@
+.. _libra-pool-mgr:
+
 Libra Node Pool Manager
 =======================
 

doc/worker/index.rst

@@ -1,3 +1,5 @@
+.. _libra-worker:
+
 Libra Gearman Worker
 ====================