Tweaks to doc/README.rst to improve reST compliance and GitHub formatting