Skip to content

docs: fix broken links (#3911) - #3957

Open
adityasharmaaaaa wants to merge 1 commit into
pytorch:mainfrom
adityasharmaaaaa:fix-broken-links-3911
Open

docs: fix broken links (#3911)#3957
adityasharmaaaaa wants to merge 1 commit into
pytorch:mainfrom
adityasharmaaaaa:fix-broken-links-3911

Conversation

@adityasharmaaaaa

Copy link
Copy Markdown

Fixes #3911

Summary

The monthly link checker flagged 25 broken links across 8 files. On investigation, these split into two distinct categories that needed different fixes.

1. Genuinely broken links (4) — fixed in source

File Old link New link Reason
intermediate_source/dist_tuto.rst cea-hpc.github.io/clustershell clustershell.readthedocs.io ClusterShell moved orgs (cea-hpcclustershell) and its docs to Read the Docs; the old GitHub Pages site no longer exists.
intermediate_source/monarch_distributed_tutorial.rst .../monarch/blob/main/scripts/install_nightly.py meta-pytorch.org/monarch/installation.html The install script was removed from the Monarch repo (confirmed 404 on raw.githubusercontent.com too). Pointed to Monarch's current official install docs instead.
intermediate_source/rpc_param_server_tutorial.rst cs.cmu.edu/~muli/file/parameter_server_osdi14.pdf usenix.org/.../osdi14-paper-li_mu.pdf The author's personal CMU page times out. Replaced with USENIX's permanently-hosted copy of the same paper (OSDI '14).
intermediate_source/rpc_tutorial.rst same CMU link same USENIX link Same paper, referenced a second time.

2. False positives (21) — added to .lycheeignore

The remaining flagged links (pytorch.org/cppdocs/* pages and two NNCF autoapi anchors) all resolve correctly and return real content when fetched normally. I manually verified several representative pages (e.g. classat_1_1_tensor.html, library_root.html, and both flagged NNCF anchors) — all 200 OK with correct content.

The CI runner is very likely being bot/rate-limit blocked by these CDNs (a known pattern for GitHub Actions IP ranges), not encountering real 404s. Per this repo's own MonthlyLinkCheck.yml guidance ("If link is valid but failing... consider adding it to .lycheeignore"), I added two regex entries with comments explaining why, so future runs don't get a false failure on these same pages.

Testing

  • Manually opened all 25 originally-flagged URLs (or their replacements) in a browser / via fetch to confirm live status before making any change.
  • No code changes — this is docs/config only.

Fixes 4 genuinely dead links (renamed/moved targets) and adds 2 lycheeignore entries for pytorch.org/cppdocs and NNCF autoapi links that 404 for the CI bot but resolve fine for real clients.
@pytorch-bot

pytorch-bot Bot commented Aug 29, 2026

Copy link
Copy Markdown

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/tutorials/3957

Note: Links to docs will display an error until the docs builds have been completed.

This comment was automatically generated by Dr. CI and updates every 15 minutes.

@meta-cla meta-cla Bot added the cla signed label Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Broken links detected in docs 🔗

1 participant