Update and reorganize the doc landing page.

Change-Id: Ica4712abb781e270b1fc7210c6705977db10a691

doc/source/index.rst

@@ -1,33 +1,69 @@
 Welcome to Barbican's developer documentation!
 ==============================================
 
-Barbican is an OpenStack service that provides secure storage,
+Barbican is the OpenStack Key Manager service. It provides secure storage,
-provisioning and management of secret data.  This includes keying material such
+provisioning and management of secret data.  This includes keying material
-as Symmetric Keys, Asymmetric Keys, Certificates and raw binary data.
+such as Symmetric Keys, Asymmetric Keys, Certificates and raw binary data.
 
-This document describes barbican for contributors of the project, and assumes
+Barbican for Users
-that you are already familiar with barbican from an end-user perspective.
+==================
 
-This documentation is generated by the Sphinx toolkit and lives in the source
+If you're trying to learn how to use barbican, you can start by reading
-tree.
+about :doc:`Secrets in the Barbican API Guide <api/userguide/secrets>`.
+
+Once you're comfortable working with secrets you can dig into the rest of the
+API.
 
-Getting Started
-===============
 .. toctree::
    :maxdepth: 1
 
    api/index
-   contribute/getting_involved
-   contribute/dependencies
-   contribute/architecture
-   contribute/dataflow
-   contribute/structure
-   contribute/database_migrations
-   setup/index
-   testing
-   admin-guide-cloud/index
-   plugin/index
 
+Barbican for Developers
+=======================
+
+If you're new to OpenStack development you should start by reading the
+`OpenStack Developer's Guide`_.
+
+.. _`OpenStack Developer's Guide`: http://docs.openstack.org/infra/manual/developers.html
+
+Once you've read the OpenStack guide you'll be ready to set up a local barbican
+development environment.
+
+.. toctree::
+   :maxdepth: 1
+
+   setup/dev
+   setup/devstack
+
+When you're ready to dive deeper in to barbican take a look at:
+
+.. toctree::
+   :maxdepth: 1
+
+   contribute/getting_involved
+   contribute/architecture
+   contribute/structure
+   contribute/dataflow
+   contribute/dependencies
+   contribute/database_migrations
+   plugin/index
+   testing
+
+Barbican for Operators
+======================
+
+If you're looking for information for deploying and configuring barbican you
+will probably want to read:
+
+.. toctree::
+   :maxdepth: 1
+
+   setup
+   admin-guide-cloud/index
+
+This documentation is generated by the Sphinx toolkit and lives in the source
+tree.
 
 
 Indices and tables