Skip to content

fix: update five dead links in the guide - #804

Merged
tkoyama010 merged 1 commit into
pyOpenSci:mainfrom
rmz-oz:fix-dead-links
Sep 26, 2026
Merged

tkoyama010 merged 1 commit into
pyOpenSci:mainfrom
rmz-oz:fix-dead-links

Conversation

@rmz-oz

@rmz-oz rmz-oz commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

Five links in the guide return 404. This updates them:

File Old New
documentation/glossary.md (Hatchling) hatch.pypa.io/latest/backend/ hatch.pypa.io/latest/config/build/
tests/run-tests.md pyopensci.org/tutorials/create-python-package.html relative link to ../tutorials/create-python-package (the tutorial is in this guide)
tests/run-tests.md scientific-python.org/tools/testing learn.scientific-python.org/development/principles/testing/
tests/run-tests-nox.md same as above same as above
documentation/repository-files/readme-file-best-practices.md github.com/hackergrrl/art-of-readme Wayback snapshot from 2023-12-31

The art-of-readme repository was deleted by its author and I couldn't find a new home for it, so I pointed at the archived copy. Happy to remove the line instead if you prefer.

Checks: every new URL returns 200; nox -s docs-test passes, and the only warning in these files (run-tests.md:191, a literalinclude start-at pattern) is on a line this PR does not touch. The relative link renders as ../tutorials/create-python-package.html.

Hatch moved its build docs, the Scientific Python testing guide moved to learn.scientific-python.org, the packaging template tutorial now lives inside this guide, and hackergrrl/art-of-readme was deleted (linked to its Wayback snapshot).

Copilot AI 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.

Copilot review overview

🟢 Approval recommended

All five targeted links are updated consistently to appropriate destinations without functional risk.

Review effort: Balanced
Findings: None

What changed in this PR

Updates five dead documentation links to valid internal, current, or archived destinations.

Changes:

  • Replaces obsolete Hatchling and Scientific Python URLs.
  • Uses an internal relative link for the packaging tutorial.
  • Links the deleted Art of README repository to an archived snapshot.
File Description
tests/​run-tests.md Updates tutorial and testing-guide links.
tests/​run-tests-nox.md Updates the Scientific Python testing link.
documentation/​repository-files/​readme-file-best-practices.md Replaces a deleted repository with its archived snapshot.
documentation/​glossary.md Updates the Hatchling documentation link.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@tkoyama010 tkoyama010 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

@tkoyama010
tkoyama010 merged commit a43e9de into pyOpenSci:main Sep 26, 2026
5 checks passed
@tkoyama010

Copy link
Copy Markdown
Member

@all-contributors please add rmz-oz for doc

@allcontributors

Copy link
Copy Markdown
Contributor

@tkoyama010

I've put up a pull request to add @rmz-oz! 🎉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants