Fixes index.rst titles and add mascot

Change based on other services docs like Nova and Cinder.

Change-Id: If96ad0bedf469934c8e4c7fcbe8c880514ae9489

doc/source/index.rst

@@ -1,12 +1,19 @@
-Welcome to the Barbican Project documentation!
-==============================================
+OpenStack Key Manager (barbican)
+================================
+
+.. figure:: images/mascot.png
+   :alt: Barbican logo
+   :width: 210
+
+What is Barbican?
+-----------------
 
 Barbican is the OpenStack Key Manager service. It provides secure storage,
 provisioning and management of secret data.  This includes keying material
 such as Symmetric Keys, Asymmetric Keys, Certificates and raw binary data.
 
 API Guide
-==========
+---------
 
 If you're trying to learn how to use barbican, you can start by reading about
 `Secrets in the Barbican API Guide <https://docs.openstack.org/api-guide/key-manager/secrets.html>`__.
@@ -22,13 +29,14 @@ API.
    install/index
    configuration/index
    contributor/index
+
 .. toctree::
    :maxdepth: 2
 
    api/index.rst
 
 Sample Files
-============
+------------
 
 .. toctree::
    :maxdepth: 2
@@ -39,7 +47,7 @@ Sample Files
 
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`