Add the ability to delete "legacy" documentation

[dstufft]

If a project has existing legacy documentation hosted on pythonhosted.org, we should allow them to delete this documentation. This should come with appropriate warnings that this is a one time, destructive operation that cannot be undone, that new uploads of documentation are no longer allowed and that they should not do it until they've moved their documentation hosting elsewhere.

We should probably include at least a suggestion of using ReadTheDocs here.

This should also provide people with the option to add a redirect when deleting their documentation so that they can redirect to their new location.

[nlhkabu]

@dstufft - is this required for shut down, or can we move it to post launch?

[dstufft]

It can be post shut down, it doesn't currently exist.

[dstufft]

Actually I lied-- We're not allowing new docs to be uploaded in Warehouse, so we'll want people to be able to delete their existing documentation so they can migrate to something else before we shut down legacy.

[bbayles]

Posting very late to an old thread, but adding my support for adding this ability. For more-itertools we added docs to RTD, but the old ones still show up on Google and there's a link to them on PyPI.

[bbayles]

Oh, there's a button for this! Never mind.

[computron]

This should also provide people with the option to add a redirect when deleting their documentation so that they can redirect to their new location.

Is there any redirect option yet? I've erased my pythonhosted docs (which can't be updated) and moved my docs elsewhere, but there are published academic papers and other materials that refer to documentation for my package as being on pythonhosted.org. Currently, following any of those links just returns an error page with no guidance of where to go next. I'm sure many users can eventually figure out where to go with Google, but it would be much better if pythonhosted allowed for a way to redirect or at least list the location of the updated docs.