You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by se...@apache.org on 2014/05/13 13:31:04 UTC

git commit: Write intro paragraph with links to individual sections

Repository: cloudstack-docs-install
Updated Branches:
  refs/heads/master 5feae430d -> d1e03dca7


Write intro paragraph with links to individual sections


Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/commit/d1e03dca
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/tree/d1e03dca
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/diff/d1e03dca

Branch: refs/heads/master
Commit: d1e03dca7b28ec608e2199ec00d3f37eef130ebe
Parents: 5feae43
Author: Sebastien Goasguen <ru...@gmail.com>
Authored: Tue May 13 13:30:54 2014 +0200
Committer: Sebastien Goasguen <ru...@gmail.com>
Committed: Tue May 13 13:30:54 2014 +0200

----------------------------------------------------------------------
 source/index.rst | 49 +++++++++++++++++++++++++++++++++----------------
 1 file changed, 33 insertions(+), 16 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack-docs-install/blob/d1e03dca/source/index.rst
----------------------------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 6fc6f62..2ff98f4 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -18,22 +18,25 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
+Welcome to CloudStack Installation Documentation
+================================================
+
 .. figure:: /_static/images/acslogo.png
     :align: center
 
-Quicklinks to CloudStack documentations:
-
-  * `Documentation home <http://docs.cloudstack.apache.org>`_
-  * `Administration Guide <http://docs.cloudstack.apache.org/projects/cloudstack-administration>`_
-  * `Release Notes <http://docs.cloudstack.apache.org/projects/cloudstack-release-notes>`_
+This is the Apache CloudStack installation guide, for the Documentation home, the administrator guide or the Release-Notes please see:
 
+- `Documentation home <http://docs.cloudstack.apache.org>`_
+- `Administration Guide <http://docs.cloudstack.apache.org/projects/cloudstack-administration>`_
+- `Release Notes <http://docs.cloudstack.apache.org/projects/cloudstack-release-notes>`_
 
+.. note:: In this guide we first go through some design and architectural choices_ to build your cloud.
+          Then we dive into a single node quick start guide_ to give you a feel for the installation process. The source installation
+          steps_ are given in the follow-on section for people who want to build their own packages. Otherwise you can use the general installation_
+          which makes use of community maintained package repositories. The rest of the guide goes through the configuration_ of the data-center and
+          the setup of the network_, storage_ and hypervisors_.
 
-Welcome to CloudStack Installation Documentation
-================================================
-
-.. toctree::
-   :maxdepth: 2
+.. _choices:
 
 Choosing a Deployment Architecture
 ----------------------------------
@@ -42,6 +45,8 @@ Choosing a Deployment Architecture
 
     choosing_deployment_architecture
 
+.. _guide:
+
 Quick Installation Guide
 ------------------------
 .. toctree::
@@ -49,12 +54,7 @@ Quick Installation Guide
 
     qig
 
-General Installation
---------------------
-.. toctree::
-    :maxdepth: 2
-
-    installation
+.. _steps:
 
 Source Installation
 -------------------
@@ -63,6 +63,17 @@ Source Installation
 
     building_from_source
 
+.. _installation:
+
+General Installation
+--------------------
+.. toctree::
+    :maxdepth: 2
+
+    installation
+
+.. _configuration:
+
 Configuration
 -------------
 .. toctree::
@@ -70,6 +81,8 @@ Configuration
 
     configuration
 
+.. _hypervisors:
+
 Hypervisor Installation
 -----------------------
 .. toctree::
@@ -81,6 +94,8 @@ Hypervisor Installation
     hypervisor/lxc.rst
     hypervisor/hyperv.rst
 
+.. _network:
+
 Network Setup
 -------------
 .. toctree::
@@ -88,6 +103,8 @@ Network Setup
 
     network_setup
 
+.. _storage:
+
 Storage Setup
 -------------
 .. toctree::