Upload to PyPI is failing when the README fails to render for 'text/x-rst'
so remobe sphinx directives and turn references in it to external links.