docs: update links to relocated PyPI documentation - #11043
Merged
radoering merged 4 commits intoSep 11, 2026
Conversation
PyPI's user documentation moved from warehouse.pypa.io/api-reference/
to docs.pypi.org, and pipx moved off pypa.github.io. Six links across
three docs pages currently 404:
warehouse.pypa.io/api-reference/json.html -> docs.pypi.org/api/json/
warehouse.pypa.io/api-reference/legacy.html#upload-api (x3)
-> docs.pypi.org/api/upload/
warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods
-> docs.pypi.org/api/#api-preference
pypa.github.io/pipx/ -> pipx.pypa.io/stable/
The XML-RPC page has no direct successor, since that API was dropped
rather than moved. The API Preference section of docs.pypi.org/api/ now
carries the deprecation notice the old anchor pointed at, so the
surrounding sentence about PyPI search still reads correctly.
All replacement URLs verified to return 200.
There was a problem hiding this comment.
Hey - I've found 1 issue
Prompt for AI Agents
Please address the comments from this code review:
## Individual Comments
### Comment 1
<location path="docs/cli.md" line_range="952" />
<code_context>
(via a browser) instead.
-For more information, please see [warehouse documentation](https://warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methods)
+For more information, please see [warehouse documentation](https://docs.pypi.org/api/#api-preference)
and this [discussion](https://discuss.python.org/t/fastly-interfering-with-pypi-search/73597/6).
{{% /note %}}
</code_context>
<issue_to_address>
**nitpick:** The link text still identifies the destination as “warehouse documentation,” but the replacement URL points to PyPI’s documentation site, misleading readers about where the guidance is hosted.
**Suggested fix:** Rename the link text to “PyPI API documentation” or similar.
```suggestion
For more information, please see [PyPI API documentation](https://docs.pypi.org/api/#api-preference)
```
</issue_to_address>Sourcery assessment
Approved.
The link now points at docs.pypi.org rather than warehouse.pypa.io, so 'warehouse documentation' no longer describes where it lands.
Contributor
Author
|
Good catch — the link text said "warehouse documentation" while pointing at Checked the other labels I touched and left them alone, since they describe their destinations accurately: "JSON API" → |
radoering
approved these changes
Sep 11, 2026
radoering
enabled auto-merge (squash)
September 11, 2026 12:47
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PyPI's user documentation moved from
warehouse.pypa.io/api-reference/todocs.pypi.org, and pipx moved offpypa.github.io. Six links across three docs pages currently 404.docs/repositories.md(L335)warehouse.pypa.io/api-reference/json.htmldocs.pypi.org/api/json/docs/repositories.md(L72, L433, L445)warehouse.pypa.io/api-reference/legacy.html#upload-apidocs.pypi.org/api/upload/docs/cli.md(L952)warehouse.pypa.io/api-reference/xml-rpc.html#deprecated-methodsdocs.pypi.org/api/#api-preferencedocs/contributing.md(L241)pypa.github.io/pipx/pipx.pypa.io/stable/Every replacement URL was checked and returns 200; the old ones return 404.
One case needed a judgement call. The XML-RPC page has no direct successor — that API was removed rather than relocated, and
docs.pypi.org/api/lists only the Index, JSON, BigQuery and Upload APIs. The deprecation notice the old#deprecated-methodsanchor pointed at now lives in the API Preference section of the API index ("No new integrations should use the XML-RPC APIs as they are planned for deprecation"), so I pointed there. The surrounding note about PyPI search still reads correctly. If you would rather drop that link entirely, say the word.Docs only; no code or behaviour changes.