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, 3 insertions, 2 deletions

diff --git a/doc/rtd/topics/dir_layout.rst b/doc/rtd/topics/dir_layout.rst
index 6dcb22ce..3f5aa205 100644
--- a/doc/rtd/topics/dir_layout.rst
+++ b/doc/rtd/topics/dir_layout.rst
@@ -1,6 +1,6 @@
-================
+****************
 Directory layout
-================
+****************
 
 Cloudinits's directory structure is somewhat different from a regular application::
 
@@ -79,3 +79,4 @@ Cloudinits's directory structure is somewhat different from a regular applicatio
   is only ran `per-once`, `per-instance`, `per-always`. This folder contains 
   sempaphore `files` which are only supposed to run `per-once` (not tied to the instance id).
 
+.. vi: textwidth=78