README.rst: small tweaks

Adding syntax highlighting for Python code and a few other minor things

Preview at https://github.com/msabramo/cuisine/tree/patch-1