Skip to content

docs: fix broken and stale outbound links across docs - #231

Merged
buddies2705 merged 2 commits into
mainfrom
docs/fix-broken-outbound-links
Aug 5, 2026
Merged

docs: fix broken and stale outbound links across docs#231
buddies2705 merged 2 commits into
mainfrom
docs/fix-broken-outbound-links

Conversation

@buddies2705

Copy link
Copy Markdown
Contributor

Summary

Full link audit of the rendered docs site (1,294 pages, ~176k href/src attributes). Internal links were already clean (0 broken routes/assets/anchors, confirmed by check-links.mjs); this PR fixes every confirmed-broken external link, plus two hygiene items, across 22 files.

Each replacement URL was HTTP-verified (200/redirect) before substitution. GitHub rate-limit (429) and bot-block (403) false-positives were filtered out via low-concurrency re-checks, so this is real signal only.

Changes

Bucket Fix
Typo http://https//bitquery.iohttps://bitquery.io
Domain migration (12 files) dexrabbit.comdexrabbit.bitquery.io (.com now 301s here)
Moved vendor docs Jupiter → dev.jup.ag/docs/swap/; Solana Web3.js → solana-foundation.github.io/solana-web3.js/; Across → .../migration-from-v2-to-v3#event-changes; Raydium → docs.raydium.io/products/clmm
Owned dead targets bitquery.io/contact (404) → support.bitquery.io; dex_trades.jsdextrades.js; removed nonexistent dex_pools.js sample bullet; delinked missing bitquery/solana-wallet-tracker repo
Dead images Removed 3 GitHub user-attachments images (404) in solana-orca-dex-api.mdx, replaced with in-file re-capture markers
Dead app link Removed app.djed.xyz bullet (unreachable); kept the working djed.xyz official-site link

⚠️ Follow-up needed (not in this PR)

  • Re-capture 3 screenshots in docs/blockchain/Solana/solana-orca-dex-api.mdx (Collect Fees / Update Fees and Rewards / Collect Reward account images) and host under /static/img. Marked with {/* TODO(re-capture) */}.
  • If a live Djed mint/redeem app URL exists, re-add that bullet in djed.md.

Explicitly deferred (out of scope)

  • ~7,376 absolute docs.bitquery.io/docs/... self-links → should become root-relative /docs/... in a separate PR.
  • explorer.bitquery.io / cardanoscan.io 403s are bot-blocks (fine in-browser), not broken.

🤖 Generated with Claude Code

Gaurav agarwal and others added 2 commits August 5, 2026 14:38
Repairs every confirmed-broken external link surfaced by a full link
audit of the rendered site (internal links were already clean).

- Typo: http://https//bitquery.io -> https://bitquery.io
- Migrate 12 files from dexrabbit.com to the canonical dexrabbit.bitquery.io
- Substitute current URLs for moved vendor docs:
  Jupiter Swap API, Solana Web3.js, Across v2->v3, Raydium CLMM
- bitquery.io/contact (404) -> support.bitquery.io
- cloud/evm.md: fix dex_trades.js -> dextrades.js, drop nonexistent
  dex_pools.js sample bullet
- Delink missing bitquery/solana-wallet-tracker repo (text kept)
- Remove 3 GitHub user-attachment images that 404'd on solana-orca-dex-api
  (replaced with in-file re-capture TODO markers)
- Remove dead Djed app (app.djed.xyz) link; keep official-site link

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The 3 GitHub user-attachment screenshots were illustrative only and had
404'd. Instead of re-capturing fragile live-subscription screenshots,
reword the sentences so they no longer point at a "following image" and
remove the TODO markers. The GraphQL query below each sentence already
shows the Instruction Accounts[] structure.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@buddies2705
buddies2705 merged commit f74894a into main Aug 5, 2026
1 check passed
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