Documentation format

[dmwyatt]

I'd like to submit some PRs for the documentation, but...its in an RST file and uses a mixture of markdown and RST.

Surprisingly, Github seems to mostly parse it ok. I was wondering if @ranahaani would accept a PR converting to all markdown or all RST so its easier to edit for the PRs I want to submit?