Some README sections were still in markdown format so turn their to rst.

Include the README as a toc in index.