Include README.rst into the documentation index so that we're not duplicating a lot of text.
Re-order pages.
Fix block formatting.
Prettify.