Skip to content

doc: fix three dead reference links - #14977

Merged
Pierre-Sassoulas merged 3 commits into
pytest-dev:mainfrom
blackorange-mega:docs/fix-dead-reference-links
Sep 6, 2026
Merged

doc: fix three dead reference links#14977
Pierre-Sassoulas merged 3 commits into
pytest-dev:mainfrom
blackorange-mega:docs/fix-dead-reference-links

Conversation

@blackorange-mega

Copy link
Copy Markdown
Contributor

Three external references in the docs no longer resolve. All checked with a browser user-agent and following redirects.

File Link Status Replacement
doc/en/how-to/output.rst windyroad.com.au/dl/Open%20Source/JUnit.xsd 404 github.com/windyroad/JUnit-Schema/blob/master/JUnit.xsd
doc/en/explanation/flaky.rst blogs.dropbox.com/tech/2016/03/open-sourcing-pytest-tools/ redirects to the dropbox.tech front page Wayback snapshot
doc/en/explanation/flaky.rst testandcode.com/50 404 Wayback snapshot

Notes:

  • The JUnit XSD is still published in the windyroad/JUnit-Schema repository, so that citation keeps pointing at the actual schema rather than an archive.
  • The Dropbox post is a soft failure — the URL still returns 200 but lands on the blog's front page, so the citation no longer reaches the article it names. Neither it nor the podcast episode has a live successor URL, so both use Wayback snapshots, matching what doc/en/history.rst already does for older dead references.
  • Per CONTRIBUTING, no changelog entry since this is a documentation fix.

I also checked the other links flagged by a scan of the docs and left them alone: stackoverflow.com/search?q=pytest and bsky.app/profile/pytest.org in contact.rst both resolve fine (they only appear broken to non-browser clients), and the remaining dead ones are inside doc/en/announce/ release notes and history.rst, which are historical records.

Three external references in the docs no longer resolve:

- how-to/output.rst cited the JUnit XSD at windyroad.com.au, which now
  404s. Point at the windyroad/JUnit-Schema repository, which still
  hosts the same schema.
- explanation/flaky.rst linked the Dropbox pytest-tools post, which
  redirects to the dropbox.tech front page rather than the article.
- explanation/flaky.rst linked testandcode.com/50, which 404s.

The two blog/podcast citations are pointed at Wayback snapshots, as
doc/en/history.rst already does for older dead references.
@psf-chronographer psf-chronographer Bot added the bot:chronographer:provided (automation) changelog entry is part of PR label Sep 6, 2026

@Pierre-Sassoulas Pierre-Sassoulas left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM, but let's remove the changelog

@Pierre-Sassoulas Pierre-Sassoulas added the skip news used on prs to opt out of the changelog requirement label Sep 6, 2026
@blackorange-mega

Copy link
Copy Markdown
Contributor Author

Done — changelog entry removed, the PR is now just the two documentation files. The Changelog entry check has gone from failing to neutral, so nothing is blocked on it.

@Pierre-Sassoulas
Pierre-Sassoulas enabled auto-merge (squash) September 6, 2026 11:31
@Pierre-Sassoulas
Pierre-Sassoulas merged commit adc4c54 into pytest-dev:main Sep 6, 2026
36 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bot:chronographer:provided (automation) changelog entry is part of PR skip news used on prs to opt out of the changelog requirement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants