Documentation no longer updated during release

[jaraco]

After switching to Warehouse for uploads in #589, the docs fail to upload with this error:

running upload_docs
Submitting documentation to https://upload.pypi.io/legacy/
Upload failed (404): Not Found

Looks like the upload_docs command defers to the repository specified for the upload command, but warehouse doesn't support that interface.

[jaraco]

@dstufft: Is doc upload support something that warehouse plans to support? Will it have a different default URL?

[dstufft]

The plan is to remove documentation hosting and direct people towards things like RTD.

[jaraco]

Specifying a repository in upload_docs doesn't work. It seems that the command still uses the repository specified in the upload section.

[jaraco]

I was wrong. Setting the repository in upload_docs does work, but it seems that the Travis docs uploader is re-using the 'server' parameter when uploading docs. If you believe the code, the server option isn't even used but instead -r pypi is passed to twine. Still, pypi_server is being passed to upload_docs, and that's the same value that's used to define the server for -r pypi, so it seems there's no way to differentiate from the server used to upload dists and the server used to upload docs.

[jaraco]

Looks like RTD has a setuptools project, but I don't own it, and it is currently rendering a stub page. Looks like getting docs to publish on RTD is going to require its own effort.

[dstufft]

I think I own that project.

[dstufft]

@jaraco is your name on RTD jaraco?

[jaraco]

@dstufft, it is.

[dstufft]

Now you're on that project too! Also if you get RTD working for setuptools, we can add it so the domain is setuptools.pypa.io for the docs.

[jaraco]

The issue above is blocking me from releasing the docs on RTD, and I've spent enough time today shaving this yak. The repo is currently in an inconsistent state, where it's not building on RTD but also won't build with setup.py build_docs, but I'm just going to leave it like that for now and hope the RTD solution can work at some point.