README.rst: small tweaks

Adding syntax highlighting for Python code and a few other minor things