Skip to content

fix: repair broken external URLs across documentation#789

Open
NoahMaizels wants to merge 4 commits intomasterfrom
broken-url-cleanup
Open

fix: repair broken external URLs across documentation#789
NoahMaizels wants to merge 4 commits intomasterfrom
broken-url-cleanup

Conversation

@NoahMaizels
Copy link
Copy Markdown
Collaborator

Summary

Dead link audit and cleanup — fixes 26+ broken, stale, or redirecting URLs across the documentation.

  • Updated Discord invite links to current canonical URLs
  • Fixed moved/renamed GitHub repos (gateway-ui, DAppNodePackage-Swarm, deboot, videoNFT, bchan-public, swarm-protocol-spec)
  • Updated blockscout, dappnode, jqlang, MetaMask, MDN, and ethereum.org URL paths
  • Replaced deprecated developer.makerdao.com/dai links with docs.gnosischain.com equivalent
  • Fixed bee-js.ethswarm.org root redirect → /docs/ directly
  • Updated internal docs.ethswarm.org self-referential links to current paths
  • Removed broken erasure-coding image, dead script-03.js link, and Galileo entry
  • Added docusaurus redirect for old erasure-coding path
  • Synced multi-author-blog.md links with newly created ethersphere/examples/multi-author-blog project

Test plan

  • Run python .claude/check_links.py --mode local after build to confirm clean report
  • Spot-check a sample of updated URLs in browser
  • Confirm Discord invite links resolve to correct servers

🤖 Generated with Claude Code

Fixes 26+ broken/stale URLs found in a dead link audit:

- Discord links updated to current invite URLs
- blockscout.com/xdai/mainnet → gnosis.blockscout.com
- dappnode.io → dappnode.com
- stedolan.github.io/jq → jqlang.github.io/jq
- MDN HTTP Status URL updated to new path
- MetaMask support URL updated to new path
- ethereum.org /en/ paths removed (redirect)
- developer.makerdao.com/dai → docs.gnosischain.com/about/tokens/xdai
- docs.ethswarm.org/docs/installation/... → updated to current paths
- github.com/ethersphere/bee/blob/master/packaging → tree/master/packaging
- github.com/ethersphere/examples/tree/main/basic-static-website → website
- papers.ethswarm.org/p/swarm-specification → swarm-protocol-spec
- swarmscan.resenje.org → swarmscan.io
- github.com/rndlabs/dappnodepackage-swarm → w3rkspacelabs/DAppNodePackage-Swarm
- github.com/awmacpherson/deboot → debootdevs/deboot
- github.com/pabloVoorvaart/videoNFT → pblvrt/videoNFT
- github.com/ethersphere/gateway → gateway-ui
- Removed broken erasure-coding image
- Removed dead manifests/directory/script-03.js link
- Removed Galileo entry (server permanently down)
- Bchan link updated to bchan-public repo
- bee-js.ethswarm.org → bee-js.ethswarm.org/docs/
- libp2p glossary URL updated
- Added docusaurus redirect for old erasure-coding path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 2, 2026

Deploy Preview for test-twitter-preview-testing-3 ready!

Name Link
🔨 Latest commit 654fda2
🔍 Latest deploy log https://app.netlify.com/projects/test-twitter-preview-testing-3/deploys/69cf0103b8ddc900089bbc28
😎 Deploy Preview https://deploy-preview-789--test-twitter-preview-testing-3.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

NoahMaizels and others added 3 commits April 3, 2026 06:37
This PR is focused on dead link fixes only; the example scripts section
belongs in the dynamic-content PR.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Moves check_links.py and check_live_links.py from .claude/ to scripts/
so they are tracked in the repo. Replaces hardcoded absolute paths with
Path(__file__).resolve().parent.parent so the scripts work for any
contributor. Reports still write to .claude/ (gitignored output dir).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Reports now go to link-reports/ instead of .claude/. The directory is
created automatically on first run. Added link-reports/ to .gitignore.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

1 participant