During the first launch of a package, I went through a series of releases because of rendering issues of
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.