docs looking much better
make sure we regenerate the readme.rst from the README.md each time we rebuild the docs
switching to reST