Skip to content

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

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

Merged
merged 5 commits into from
Nov 20, 2024

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
@di di enabled auto-merge (squash) November 20, 2024 22:54
@di di merged commit b8eb325 into pypi:main Nov 20, 2024
20 checks passed
@woodruffw woodruffw deleted the ww/mv-index-api-docs branch November 20, 2024 22:59
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.

2 participants