X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/700bb8436756cac2f026ee658ccc30113d5a1a96..f5c4553bca680cf3cc9997ec9e12f260f1e3ee68:/doc/index.rst

diff --git a/doc/index.rst b/doc/index.rst
index feeb8cf..63dd073 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -4,21 +4,141 @@
 Welcome to Ganeti's documentation!
 ==================================
 
-Contents:
+This page is the starting point for browsing the ganeti documentation. It
+contains link to all the sections of the documentation, grouped by topic.
 
+The list of changes between Ganeti versions is provided in the :doc:`news` file.
+
+In order to help understanding the Ganeti terminology, a :doc:`glossary` is
+provided.
+
+Also see the :ref:`search`.
+
+Installing Ganeti
++++++++++++++++++
+
+In order to install Ganeti, follow the instructions contained in the
+:doc:`install`.
+
+If you are an experience user, the content of the :doc:`install-quick` should
+be enough.
+
+Instructions for upgrading an existing installation to the latest version of
+Ganeti are contained in the :doc:`upgrade`.
+
+Using Ganeti
+++++++++++++
+
+Information about how to manage a Ganeti cluster after it has been installed
+(including management of nodes, instances, info about the tools and the
+monitoring agent) can be found in :doc:`admin`.
+
+A more example-oriended guide is available in :doc:`walkthrough`.
+
+The various tool that are part of Ganeti are described one by one in the
+:doc:`manpages`.
+
+A description of the security model underlying a Ganeti cluster can be find in
+the :doc:`security` document.
+
+Ganeti functionalities can be extended be hooking scripts automatically
+activated when certain events happen. Information on this mechanism is provided
+in the :doc:`hooks` document.
+
+While using Ganeti, the allocation of instances can happen manually or
+automatically, through some external tool making decisions about this. The API
+for such tools is described in :doc:`iallocator`.
+
+Most of the functionalities of Ganeti can be programmatically accessed through
+an API, the :doc:`rapi`.
+
+Compatibility with the standard OVF virtual machine interchange format is
+provided by the :doc:`ovfconverter`.
+
+Mainly for testing reasons, Ganeti also has :doc:`virtual-cluster`.
+
+A few functionalities are explicitly targeted for big installations, where
+multiple clusters are present. A tool for merging two existing clusters
+is provided, and is described in :doc:`cluster-merge`. There is also a document
+describing the procedure for :doc:`move-instance`.
+
+Developing Ganeti
++++++++++++++++++
+
+A few documents useful for who wants to modify Ganeti are available and listed
+in this section.
+
+A description of the locking strategy and, in particular, lock order
+dependencies is presented in :doc:`locking`.
+
+Build dependencies and other useful development-related information are provided
+in the :doc:`devnotes`.
+
+All the features implemented in Ganeti are described in a design document before
+being actually implemented. Designs can be implemented in a released version, or
+be still draft (and therefore either incomplete or not implemented).
+
+Implemented designs
+-------------------
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
-   install.rst
-   admin.rst
-   security.rst
    design-2.0.rst
    design-2.1.rst
-   locking.rst
+   design-2.2.rst
+   design-2.3.rst
+   design-htools-2.3.rst
+   design-2.4.rst
+   design-2.5.rst
+   design-2.6.rst
+   design-2.7.rst
+   design-2.8.rst
+
+Draft designs
+-------------
+.. toctree::
+   :maxdepth: 2
+
+   design-draft.rst
+
+.. toctree::
+   :hidden:
+
+   admin.rst
+   cluster-merge.rst
+   design-autorepair.rst
+   design-bulk-create.rst
+   design-chained-jobs.rst
+   design-cpu-pinning.rst
+   design-linuxha.rst
+   design-lu-generated-jobs.rst
+   design-multi-reloc.rst
+   design-network.rst
+   design-node-add.rst
+   design-oob.rst
+   design-opportunistic-locking.rst
+   design-ovf-support.rst
+   design-query2.rst
+   design-reason-trail.rst
+   design-restricted-commands.rst
+   design-shared-storage.rst
+   design-virtual-clusters.rst
+   devnotes.rst
+   glossary.rst
    hooks.rst
    iallocator.rst
+   install.rst
+   install-quick.rst
+   locking.rst
+   manpages.rst
+   monitoring-query-format.rst
+   move-instance.rst
+   news.rst
+   ovfconverter.rst
    rapi.rst
-   devnotes.rst
-   glossary.rst
+   security.rst
+   upgrade.rst
+   virtual-cluster.rst
+   walkthrough
 
-Also see the :ref:`search`.
+.. vim: set textwidth=72 :