FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Check newly added links in PRs by navya-exe · Pull Request #2135 · pypa/packaging.python.org · GitHub

Repository navigation

Check newly added links in PRs - #2135

Open
navya-exe wants to merge 2 commits into
pypa:mainfrom
navya-exe:linkcheck-new-links
Open

navya-exe wants to merge 2 commits into
pypa:mainfrom
navya-exe:linkcheck-new-links

Conversation

navya-exe commented Sep 21, 2026 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown

Fixes #2037

This changes the linkcheck setup so that, during pull requests and merge queues, links that already existed in the base revision are ignored.

A cached linkcheck baseline from the base revision is restored before linkcheck runs, while the baseline is updated from the main branch.

This allows PR linkcheck to focus on newly added links.

Local validation:

  • python -m compileall source/conf.py
  • python -m nox -s linkcheck
  • python -m nox -s build
  • YAML validation
  • git diff --check

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

rgommers added the type: maintenance Regular maintenance of the guide, CI and repo label Nov 10, 2026

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.

Choose a reason Spam Abuse Off Topic Outdated Duplicate Resolved Low Quality

This follows the approach suggested in #2037, but it seems like a drive-by PR. At least three gaps need addressing:

  • The escaped URLs need end anchors. As written, a known URL like https://example.org/docs also suppresses checks for newly added /docs/new-page or #missing-anchor URLs.
  • The workflow retains continue-on-error for PRs and merge queues, so newly introduced broken links still won’t block merging.
  • There’s no cache-miss fallback. If the exact-base cache is unavailable, the job silently checks every link again. It should generate the baseline on demand, or explicitly report that filtering could not be applied.

I implemented a much more comprehensive approach in gh-2182 that doesn't have these problems. I'm inclined to close this PR.

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

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Linkcheck for newly add links in PRs

2 participants


Back | FazBrowse Home | New Git URL