Add some documentation for cluster management

[kamaki] / docs / index.rst

diff --git a/docs/index.rst b/docs/index.rst
index 9a4fe51..3e57d74 100644 (file)
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,11 +8,12 @@ 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 OpenStack APIs,
+along with the custom extensions introduced by Synnefo
+(`Synnefo IaaS <http://www.synnefo.org/>`_).
 
 ./kamaki is open source and released under a 2-clause BSD License.
 
@@ -30,6 +31,7 @@ Contents:
    setup
    usage
    commands
+   examples
    devguide