Skip to content

docs: update permanently redirected links - #2174

Merged
rgommers merged 1 commit into
pypa:mainfrom
henryiii:linkcheck-redirects
Oct 29, 2026
Merged

rgommers merged 1 commit into
pypa:mainfrom
henryiii:linkcheck-redirects

Conversation

@henryiii

@henryiii henryiii commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Ignore hosted.weblate.org in linkcheck, which now returns 403 to automated requests.

This should reduce the number of linkcheck notices about permanent redirects that show up. A few were a bit more complex than renames (see below for details). Some things probably need reworking too (like dual links to the same anaconda page), but that's something for later.

🤖 AI summary of an intermediate state 🤖:

I ran the linkcheck and updated 36 permanent-redirect (301) links in 16 .rst files, on the new branch linkcheck-redirects. A second linkcheck run confirms that all the updated links now resolve directly. prek -a passes. I did not commit.

Changes to check before you commit:

  • Anaconda and Miniconda: both old links now redirect to the same page (anaconda.com/docs/getting-started/concepts/anaconda-or-miniconda), so both links in the text now go there.
  • BigQuery quickstart: the old link now redirects to docs.cloud.google.com/bigquery/docs/sandbox, which is a different page from the original web-UI quickstart.
  • Anchors:
    • The GitHub environments link keeps its #creating-an-environment anchor, because the new page still has it.
    • The PyPI project-size-limit link now points to docs.pypi.org/project-management/storage-limits/#project-size-limits.
    • The PEX link drops its old #user-content-pex anchor.
  • Safety: the link now goes to getsafety.com/cli/, without the tracking parameters that the redirect adds.

Links I did not change:

  • pypi.org/help/#apitoken now redirects to the docs.pypi.org home page, and that site has no API token page. Updating it would lose the anchor.
  • labs.fedoraproject.org/.../python-classroom/ now redirects to a general Fedora Labs page, not a Python Classroom page.
  • discuss.python.org/t/22299 and /c/packaging are short forms that the site expands. They work as they are.
  • toml.io redirects to toml.io/en/, and cryptography-vectors redirects only to a different form of the same PyPI project name.

Broken link: hosted.weblate.org returns 403. This is probably a block on automated requests, not a dead page.


📚 Documentation preview 📚: https://python-packaging-user-guide--2174.org.readthedocs.build/en/2174/

Also ignore hosted.weblate.org in linkcheck, which returns 403 to automated requests.

Assisted-by: ClaudeCode:claude-opus-5-5
@henryiii
henryiii requested a review from webknjaz as a code owner October 29, 2026 15:18

@rgommers rgommers left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks @henryiii. I checked the items from the PR description it said needed checking, that all looks fine.

@rgommers
rgommers added this pull request to the merge queue Oct 29, 2026
@rgommers rgommers added the type: maintenance Regular maintenance of the guide, CI and repo label Oct 29, 2026
Merged via the queue into pypa:main with commit 6fa4790 Oct 29, 2026
10 of 11 checks passed
@henryiii

Copy link
Copy Markdown
Contributor Author

Great, thanks! I checked most of them too.

@henryiii
henryiii deleted the linkcheck-redirects branch October 29, 2026 20:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: maintenance Regular maintenance of the guide, CI and repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants