README.rst: small tweaks

Adding syntax highlighting for Python code and a few other minor things
Merge pull request #178 from msabramo/patch-1

README.rst: small tweaks