docs: Finish README conversion from markdown to rst and update index
Some README sections were still in markdown format so turn their to rst.
Include the README as a toc in index.
Staging instance, all changes can be removed at any time
Some README sections were still in markdown format so turn their to rst.
Include the README as a toc in index.