Update and rename README.md to README.rst

Quick notes and caveats