Skip to content

docs: fix pre-existing broken links surfaced by Link Check#1243

Merged
SahilAujla merged 2 commits intomainfrom
docs/styler/cleanup-broken-links-2026-04
Apr 22, 2026
Merged

docs: fix pre-existing broken links surfaced by Link Check#1243
SahilAujla merged 2 commits intomainfrom
docs/styler/cleanup-broken-links-2026-04

Conversation

@JackReacher0807
Copy link
Copy Markdown
Collaborator

Summary

Dedicated cleanup PR for the 80 broken-link errors across 23 files that the Link Check surfaced on #1241 (those URLs aren't touched by that PR). Fixing them here so future content PRs get a clean Link Check status.

Linear: DOCS-51
Source report: https://github.com/alchemyplatform/docs/actions/runs/24684558214/job/72190492536

Totals

Category Count Action
Stale docs-lilac-beta.vercel.app (= bad relative paths on prod) ~74 rewrite to canonical /docs/... paths
Production alchemy.com 404s 4 rewrite to live slugs
Third-party 404 (eth-infinitism v0.8.0) 1 replace with canonical EIP-4337 URL
Third-party 404 (help.safe.global) 1 replace with https://safe.global/ landing
Third-party 404 (jovay registry) 2 inline tag as literal text (historical changelog)
Goerli faucet 403 2 replace with Sepolia faucet (Goerli sunset)
Transient 429 (docs.arbitrum.io) 1 skipped — CI flake, not a real break

Net: 22 files touched, 57 lines changed (many on a single multi-column table).

Per-file changes

File Action
content/api-reference/op-mainnet/op-mainnet-api-faq/op-mainnet-api-faq.mdx Goerli → Sepolia faucet; updated surrounding prose
content/api-reference/arbitrum/arbitrum-api-faq/arbitrum-api-faq.mdx Goerli → Sepolia faucet; updated surrounding prose
content/api-reference/introduction/api-overview.mdx Transaction APIs card → /docs/wallets/transactions/send-transactions
content/api-reference/hyperevm/hyperevm-api-overview.mdx 54 method links rewritten to /docs/chains/hyperliquid/hyperliquid-evm-endpoints/<method> (real canonical path for HyperEVM methods)
content/api-reference/katana/katana-api-overview.mdx Removed link to nonexistent /docs/reference/katana-api-quickstart; reworded the intro line
content/wallets/pages/authentication/overview.mdx Dynamic row → custom-integration guide (no dedicated Dynamic page exists in tree)
content/wallets/pages/recipes/onramp-funds.mdx core/quickstartquickstart
content/wallets/pages/recipes/send-usdc.mdx core/quickstartquickstart
content/wallets/pages/recipes/upgrade-to-smart-accounts.mdx All 4 broken cards (core/quickstart, react/installation, two react-native slugs) → /docs/wallets/quickstart
content/wallets/pages/recipes/smart-wallets-aave.mdx /docs/wallets/react/setup/docs/wallets/quickstart
content/wallets/pages/smart-wallets/how-to-stamp-requests.mdx core/quickstartquickstart
content/wallets/pages/smart-wallets/quickstart/index.mdx url: frontmatter pointed at the live canonical (https://www.alchemy.com/docs/wallets/quickstart) since the page isn't registered in docs.yml
content/wallets/pages/concepts/smart-account-client.mdx Both reference/smart-wallet-quickstart links → /docs/wallets/quickstart
content/wallets/pages/react-native/getting-started/getting-started-rn-bare.mdx app-integration/docs/wallets/quickstart
content/wallets/pages/react-native/getting-started/getting-started-expo.mdx app-integration/docs/wallets/quickstart
content/wallets/pages/index.mdx Session keys card → /docs/wallets/reference/wallet-apis-session-keys; Recipes card → /docs/wallets/recipes/overview
content/wallets/pages/bundler-api/bundler-faqs.mdx ERC-4337 v0.8.0 GitHub blob → https://eips.ethereum.org/EIPS/eip-4337
content/tutorials/alchemy-university/smart-contract-basics/multi-sig-contracts.mdx help.safe.global article → https://safe.global/
content/changelog/2025-08-28.md wallets/transactions/overviewwallets/transactions/send-transactions
content/changelog/2025-09-18.md wallets/transactions/overviewwallets/transactions/send-transactions
content/changelog/2026-03-26.md Added missing /docs prefix to /reference/tempo-api-quickstart and /wallets/transactions/debug-transactions
content/changelog/2026-04-09.md Unlinked the Jovay registry URL on both Jovay Mainnet and Testnet lines (historical tag, link target is gone)

Intentionally skipped

  • content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdxdocs.arbitrum.io/welcome/arbitrum-gentle-introduction#arbitrum-nova — 429 (Too Many Requests). The URL is fine, the rate limit is a CI flake. Left alone.

Notes / judgment calls

  • Canonical Hyperliquid EVM method path is /docs/chains/hyperliquid/hyperliquid-evm-endpoints/<method> (verified live). The old links used both the wrong chain slug (hyperevm) and the wrong endpoints slug (hyper-evm-api-endpoints).
  • /docs/wallets/transactions/overview has a redirect to /docs/wallets, but the preview deploy still 404s it (likely redirect lag). Swapping to a first-class page (send-transactions) removes the flake from future Link Checks.
  • Per guidance, did not create new pages (e.g., per-method HyperEVM pages, a Dynamic signer page, a Katana quickstart) — linked to the closest existing parent instead.
  • pnpm run lint passes (ran eslint, prettier --check, and tsc --noEmit individually — all clean). pnpm run validate is OpenAPI/OpenRPC-spec validation and not relevant to this content-only change, so skipped.

Cleanup surfaced by Link Check on PR #1241.
- Replaced ~54 stale docs-lilac-beta.vercel.app links in the hyperevm
  overview with /docs/chains/hyperliquid/hyperliquid-evm-endpoints URLs.
- Updated wallets docs to link to /docs/wallets/quickstart (canonical)
  instead of the retired /docs/wallets/core/quickstart,
  /docs/wallets/react/installation, /docs/wallets/react/setup,
  /docs/wallets/reference/smart-wallet-quickstart, and stale
  react-native getting-started slugs.
- Fixed changelog links missing the /docs prefix
  (/reference/tempo-api-quickstart, /wallets/transactions/debug-transactions).
- Pointed Transactions overview cards at send-transactions (the overview
  slug isn't registered in docs.yml and 404s on prod).
- Redirected wallets/index.mdx session keys card to
  /docs/wallets/reference/wallet-apis-session-keys and Recipes card to
  /docs/wallets/recipes/overview (the bare /docs/wallets/recipes 404s).
- Routed the authentication overview Dynamic row to the custom-integration
  guide (no dedicated Dynamic page exists).
- Replaced dead third-party links: ERC-4337 v0.8.0 GitHub blob ->
  eips.ethereum.org canonical EIP, help.safe.global article ->
  https://safe.global, and inlined the Jovay registry tag as literal text
  (historical changelog entry).
- Replaced Goerli faucet references with the Sepolia faucet in the
  Arbitrum and OP Mainnet FAQ (Goerli is sunset; link returned 403).

Skipped: the transient 429 on docs.arbitrum.io
(arbitrum-nova-deprecation-notice) is a CI flake, not a real break.
@JackReacher0807 JackReacher0807 requested a review from a team as a code owner April 21, 2026 06:54
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 21, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Apr 21, 2026, 6:08 PM

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 21, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 7888
✅ Successful 6810
⏳ Timeouts 2
🔀 Redirected 399
👻 Excluded 674
❓ Unknown 0
🚫 Errors 2
⛔ Unsupported 1
Broken links (2) — click to expand

Errors per input

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

Errors in ./content/tutorials/alchemy-university/ethereum-basics/how-ethereum-transactions-work.mdx

View workflow run

Comment thread content/wallets/pages/recipes/upgrade-to-smart-accounts.mdx Outdated
Comment thread content/api-reference/hyperevm/hyperevm-api-overview.mdx
Respond to PR review: the four framework-specific quickstart pages
(React, core, React Native Expo, React Native Bare) no longer exist
as distinct destinations after the Wallet APIs rebrand. All four
cards pointed at /docs/wallets/quickstart, which was bad UX.

Collapsed into a single card pointing at the unified Wallet APIs
Quickstart, which covers React, other JS frameworks, and React Native.
@SahilAujla SahilAujla merged commit d8540c8 into main Apr 22, 2026
12 of 13 checks passed
@SahilAujla SahilAujla deleted the docs/styler/cleanup-broken-links-2026-04 branch April 22, 2026 14:44
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