This moves the "legacy" API docs into two new user-docs pages:
"Index API" for the PEP 503/691 APIs
"Upload API" for PyPI's upload API
Combined, these two new docs have almost exactly the same contents as the old legacy.rst, but with a few cleanups and cross-links to things like the Integrity API.
I've also used the phrase "Index API" instead of "legacy API," since the former appears to cause confusion among users (they think it means the API is deprecated, when really it means it was migrated from the "legacy" PyPI). I'm happy to change that back, though!
I've left legacy.rst as a stub page with some links so that people can follow to the new docs, but I think another option here would be to remove it entirely and let search engines reindex on the new pages.
This moves the "legacy" API docs into two new user-docs pages:
Combined, these two new docs have almost exactly the same contents as the old
legacy.rst, but with a few cleanups and cross-links to things like the Integrity API.I've also used the phrase "Index API" instead of "legacy API," since the former appears to cause confusion among users (they think it means the API is deprecated, when really it means it was migrated from the "legacy" PyPI). I'm happy to change that back, though!
I've left
legacy.rstas a stub page with some links so that people can follow to the new docs, but I think another option here would be to remove it entirely and let search engines reindex on the new pages.See https://github.com/pypi/warehouse/issues/16541.