doc: make the RST files consistently formated and other improvements.

The biggest things here are:
 * move doc/sources/*/README.rst to doc/rtd/topics/datasources
   This gives each datasource a page in the rtd docs, which make
   it easier to read.
 * consistently use the same header style throughout.
   As suggested at
   http://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html
   use:
     # with overline, for parts
     * with overline, for chapters
     =, for sections
     -, for subsections
     ^, for subsubsections
     “, for paragraphs

Also, move and re-format vendor-data documentation to rtd.

1 files changed, 34 insertions, 0 deletions

diff --git a/doc/rtd/topics/datasources/cloudstack.rst b/doc/rtd/topics/datasources/cloudstack.rst
new file mode 100644
index 00000000..04603d9c
--- /dev/null
+++ b/doc/rtd/topics/datasources/cloudstack.rst
@@ -0,0 +1,34 @@
+CloudStack
+==========
+
+`Apache CloudStack`_ expose user-data, meta-data, user password and account
+sshkey thru the Virtual-Router. For more details on meta-data and user-data,
+refer the `CloudStack Administrator Guide`_. 
+
+URLs to access user-data and meta-data from the Virtual Machine. Here 10.1.1.1
+is the Virtual Router IP:
+
+.. code:: bash
+
+    http://10.1.1.1/latest/user-data
+    http://10.1.1.1/latest/meta-data
+    http://10.1.1.1/latest/meta-data/{metadata type}
+
+Configuration
+-------------
+
+Apache CloudStack datasource can be configured as follows:
+
+.. code:: yaml
+
+    datasource:
+      CloudStack: {}
+      None: {}
+    datasource_list:
+      - CloudStack
+
+
+.. _Apache CloudStack: http://cloudstack.apache.org/
+.. _CloudStack Administrator Guide: http://docs.cloudstack.apache.org/projects/cloudstack-administration/en/latest/virtual_machines.html#user-data-and-meta-data
+
+.. vi: textwidth=78