During the first launch of a package, I went through a series of releases because of rendering issues of README.rst on pypi. I pulled up my new package on pypi and was met with unseemly, unformatted text instead of a spiffy display. To avoid that, you can use
python setup.py check --restructuredtext
It tested the READEM.rst locally, and it would “warn” you errors.