Skip to content

fix: repair broken external links across docs#2207

Merged
GigaHierz merged 5 commits into
mainfrom
GigaHierz/fix-broken-links
Jun 26, 2026
Merged

fix: repair broken external links across docs#2207
GigaHierz merged 5 commits into
mainfrom
GigaHierz/fix-broken-links

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

Summary

Swept all external URLs in the active docs (re-checking GitHub links separately, since GitHub soft-404s to browser scanners), then fixed every genuine 404. Mintlify's internal link checker (mint broken-links) stays clean, and every replacement URL was verified to resolve (HTTP 200).

28 links fixed across 21 files.

What changed

Vendor docs that moved
MetaMask ×2 (new json-rpc-methods pages), Self.xyz ×5 (→ /docs/self-pass/…), Jaw.id ×2 (siwe, subscription), Quex (→ consumer/getting_started), POKT (→ new docs.pocket.network host), Dynamic, Para, Witnet, OpenZeppelin, Coinbase Wallet ×2 (→ Base smart-wallet docs).

GitHub repo restructures
celo-composer hardhat config (→ template path), Validators.sol (→ contracts-0.8/), CGP 0016.md + template.md (→ migrated governance repo), ODIS source links (→ social-connect SDK).

Dead project hosts
Credit Collective (→ credit-collective.com), MCP community forum (→ GitHub Discussions), indexing.co Platform link.

Deprecated content
SETUP.md → celo-monorepo README; Mento oracle Helm chart → archived helm-charts-deprecated repo (worded as archived); ODIS examples → social-connect ODIS dir; ContractKit live sample RPC → Celo Sepolia forno.

Intentionally not touched

  • legacy/ and _deprecated/ pages
  • Placeholder example URLs (someuser/someplugin, cgp-00000.md, etc.)
  • localhost / in-code endpoint samples and the indexing.co curl API examples
  • 403 (bot-blocked) and 401 (auth-gated) URLs — these resolve fine in a browser

Verification

  • mint broken-links → "no broken links found"
  • Every changed external URL re-checked with plain curl → 200 (GitHub checked without a browser UA to avoid soft-404s)

🤖 Generated with Claude Code

Swept all external URLs in the active docs and replaced genuine 404s
(verified each replacement now returns 200). Internal links unaffected.

- Vendor docs that moved: MetaMask, Self, Jaw.id, Quex, POKT, Dynamic,
  Para, Witnet, OpenZeppelin, Coinbase Wallet
- GitHub repo restructures: celo-composer, Validators.sol, CGP links
  (migrated to governance repo), ODIS source (moved to social-connect)
- Dead project hosts: Credit Collective, MCP community, indexing.co
- Deprecated content: SETUP.md -> README, oracle Helm chart -> archived
  repo, ContractKit sample RPC -> Celo Sepolia forno

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@GigaHierz GigaHierz requested review from a team as code owners June 25, 2026 12:53
@GigaHierz GigaHierz requested review from karlb and seolaoh and removed request for a team June 25, 2026 12:53
@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
celo-docs 🟢 Ready View Preview Jun 25, 2026, 12:57 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread build-on-celo/fee-abstraction/add-fee-currency.mdx Outdated
Comment thread contribute-to-celo/release-process/smart-contracts.mdx Outdated
Comment thread tooling/overview/setup/windows.mdx Outdated
Comment thread tooling/libraries-sdks/contractkit/odis.mdx
Co-authored-by: Seola Oh <osa8361@gmail.com>
GigaHierz and others added 2 commits June 26, 2026 11:35
Co-authored-by: Seola Oh <osa8361@gmail.com>
Co-authored-by: Seola Oh <osa8361@gmail.com>
The ODIS guide documented APIs that were deprecated or removed, so
repointing the dead links alone kept removed functionality looking
current.

- Use OdisUtils.Identifier.getObfuscatedIdentifier. The older
  getPhoneNumberIdentifier is deprecated and just forwards to it; the
  response is now IdentifierHashDetails (obfuscatedIdentifier, not
  phoneHash).
- Drop the ReactBlsBlindingClient snippet. Only WasmBlsBlindingClient is
  shipped, and its constructor throws in React Native and in the browser,
  so point browser/RN users at a web blinding client example instead.
- Remove the Matchmaking section. getContactMatches / matchmaking.ts were
  removed in the ODIS 2.0.0 refactor (celo-org/celo-monorepo#9693) and
  social-connect's OdisUtils has no Matchmaking export.
- Replace the dead valora wallet example link with the maintained
  celo-org/SocialConnect-Twitter sample app.

All source links are pinned to a commit SHA instead of a branch so they
do not rot again.

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

LGTM!

@GigaHierz GigaHierz merged commit fb9404f into main Jun 26, 2026
4 checks passed
@GigaHierz GigaHierz deleted the GigaHierz/fix-broken-links branch June 26, 2026 11: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.

2 participants