Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: migrate index/upload API docs to user docs #17123

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

woodruffw
Copy link
Member

This moves the "legacy" API docs into two new user-docs pages:

  1. "Index API" for the PEP 503/691 APIs
  2. "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.

See #16541.

Signed-off-by: William Woodruff <[email protected]>
Signed-off-by: William Woodruff <[email protected]>
@woodruffw woodruffw self-assigned this Nov 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant