renamed README.txt to README.rst

This way it is properly rendered in the project's main page.

Also fixed some minor formatting.
Using correct RST formatting in README
Merged readme changes.