Add a new section "Scenarios" in documentation

[kamaki] / docs / index.rst

diff --git a/docs/index.rst b/docs/index.rst
index 7c34cc8..cda3ee2 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,27 +8,30 @@ Kamaki project documentation
 
 .. image:: /images/kamaki-logo.png
 
-./kamaki is a simple, yet intuitive, command-line tool for managing clouds. Run
-it without arguments to see a list of available commands.
+./kamaki is a multipurpose, interactive command-line tool and also a client development API for managing clouds.
 
-It is an initial implementation of the OpenStack Compute API, v1.1, with custom
-extensions specific to the Synnefo IaaS cloud management software.
+As a development library, it implements the Synnefo API (
+`Synnefo IaaS <http://www.synnefo.org/>`_ cloud management software) which
+extends OpenStack, therefore is also compatible with the OpenStack API.
 
-./kamaki is open source and released under a 2-clause BSD Licence.
+./kamaki is open source and released under a 2-clause BSD License.
 
 
 Contents:
 *********
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
+   :numbered:
+   :glob:
    
    overview
    installation
    setup
    usage
-   clients
-   cli
+   commands
+   scenarios
+   devguide
 
 
 Indices and tables
@@ -37,4 +40,3 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-