Right now PyPI supports the ability for people to upload zip files containing raw HTML that we'll then host at https://pythonhosted.org/{projectname}/. Ideally I'd like to stop being in the documentation hosting business and instead direct people to use ReadTheDocs. This was proposed before on distutils-sig however it was ultimately shot down because some people don't use Sphinx in their documentation toolchain and they want/need to be able to upload raw html.

After talking with @ericholscher this is a use case that ReadTheDocs wants to support, so I believe once RTD does, we can work on moving people over to using that instead. This issue will be about capturing what work needs done to enable such a transition.

In addition it would be great to have better integration between RTD and PyPI. Currently having your documentation hosted on PyPI gives a somewhat better link to the documentation than having that documentation in RTD does. We should prefer integrations that bias users towards using RTD and try to figure out what an ideal integration looks like. It's possible that this could be used as a model for additional integrations, both for Warehouse integrating with other services (code quality? i18n?) and for other package repositories wanting to integrate with RTD.