Some README sections were still in markdown format so turn their to rst. Include the README as a toc in index.