Skip to content

docs: update redirected and dead links from link checker report - #1202

Open
rezamuliawijaya wants to merge 2 commits into
napari:mainfrom
rezamuliawijaya:docs/fix-broken-links
Open

rezamuliawijaya wants to merge 2 commits into
napari:mainfrom
rezamuliawijaya:docs/fix-broken-links

Conversation

@rezamuliawijaya

Copy link
Copy Markdown

Fixes #1201

What

Updates the links flagged in the Link Checker Report that resolve to a stable new destination. Each replacement URL was verified with curl to return 200 before being used:

  • GitHub docs reorganized their URL tree — 10 links updated (contributing guides, core team guide, fork/PR pages, events docs, commit-email setup).
  • VS Code renamed the debugging page (/docs/editor/debugging → /docs/debugtest/debugging) and moved keybindings to /docs/configure/keybindings.
  • conda.io pages moved under docs.conda.io.
  • Qt 5 docs now live under /archives/qt-5.15/.
  • DeepLabCut moved from mackenziemathislab.org to mlabofai.org.
  • pydantic docs moved to pydantic.dev/docs/validation/.
  • Plus: brain-map.org, linnarssonlab.org (mousebrain), biii.eu (https), Dryad dataset path, pytest/xarray stable docs, codecov.io → about.codecov.io, EffVer's current home, issue→PR link for #5943, and a tree→blob GitHub link.

20 files, 31 one-line link edits — no prose changes.

What is intentionally left alone

  • DOI links (doi.org, dx.doi.org) — persistent identifiers are supposed to redirect; resolving them to publisher URLs would break citation stability.
  • Auth-walled GitHub pages (org team page, conda-forge issue-template chooser) — the login redirect is expected behavior for anonymous requests.
  • /releases/latest and /releases/download/... links — the signed-asset redirect is GitHub's normal download behavior, and latest is intentionally a moving target.
  • The Google Slides link that now requires sign-in — the deck appears restricted; worth a separate decision by the team.

Notes for reviewers

  • One report entry pointed at plugins/technical_references/contributions.md for a Qt link that no longer exists in that file (the content moved since the report was generated) — nothing to change there.
  • The report's line numbers had shifted; replacements were matched by exact URL string instead.

Refresh the links flagged in the Link Checker Report (napari#1201) that resolve
to a stable destination: GitHub docs reorganized their URL tree, VS Code
renamed the debugging and keybinding pages, conda.io moved under
docs.conda.io, Qt 5.15 pages now live under /archives, and DeepLabCut
moved to mlabofai.org. Each replacement URL was verified to return 200.

Left intentionally unchanged: DOI doi.org links (persistent identifiers
must keep redirecting rather than be resolved), GitHub pages that require
an authenticated session (team page, issue template chooser), and
/releases/latest and /releases/download asset URLs whose redirects are
GitHub's normal download behavior.

Fixes napari#1201

Signed-off-by: Reza Mulia Wijaya <112234018+rezamuliawijaya@users.noreply.github.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 6, 2026
@github-actions

github-actions Bot commented Nov 6, 2026

Copy link
Copy Markdown

@lundybernard

Copy link
Copy Markdown
Contributor

I have several PRs in-flight and one merged that also address the link-check report.

#1210 #1208 #1207
and just merged #1206

I'll review this PR against those to check for overlap and see if it covers any gaps in mine.

@TimMonko

TimMonko commented Nov 6, 2026

Copy link
Copy Markdown
Member

I have several PRs in-flight and one merged that also address the link-check report.

#1210 #1208 #1207 and just merged #1206

I'll review this PR against those to check for overlap and see if it covers any gaps in mine.

Thank you @lundybernard , that would be marvelous! I won't move super quickly on the link checks until next week :)

@Aniketsy Aniketsy added the maintenance CI, dependencies, and other maintenance label Nov 9, 2026

@Aniketsy Aniketsy 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.

@rezamuliawijaya Thank you for the work ;)

LGTM 👍

it was little exhausting, going link by link, is there any other way to check these link updating PRs 😀 ... 🤷

@brisvag brisvag 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.

Yeah let's wait for @lundybernard's work to merge (which is more structured and explained), then see if there's stuff here.

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

Labels

documentation Improvements or additions to documentation maintenance CI, dependencies, and other maintenance

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

Link Checker Report

5 participants