Skip to content

fix(docs): redirect legacy /chain/onboarding to Get Started - #2056

Open
youssefea wants to merge 1 commit into
masterfrom
fix/redirect-legacy-chain-onboarding
Open

youssefea wants to merge 1 commit into
masterfrom
fix/redirect-legacy-chain-onboarding

Conversation

@youssefea

Copy link
Copy Markdown
Contributor

What changed? Why?

Adds one redirect to docs/docs.json: /chain/onboarding → /get-started/base.

https://www.base.org/tools/onboarding (and https://base.org/tools/onboarding) is redirected by base.org's apps/web/proxy.ts to https://docs.base.org/chain/onboarding, which currently returns HTTP 404. /chain/onboarding is an established legacy docs URL: it was a published page (_pages/chain/onboarding.mdx) before the Mintlify migration. Its successor, /base-chain/tools/onboarding, was removed in #1214 and already redirects to /get-started/base; /chain/onramps uses the same destination. Fixing it in docs also covers any other inbound links to the old URL.

Notes to reviewers

  • Only redirect-only change; no content edits.
  • Destination checked: https://docs.base.org/get-started/base returns 200.

How has it been tested?

  • curl -sL -w '%{http_code} %{url_effective}' https://www.base.org/tools/onboarding → 404 https://docs.base.org/chain/onboarding (reproduced on repeated runs, before this change)
  • npm test → 113 pass, 0 fail
  • node scripts/validate-docs-structure.js → "Navigation, orphans, redirects, scoped internal links, and the Base Std route table are valid."
  • No duplicate redirect sources in docs.json (checked with a script)
  • npx mint broken-links → 2 broken links, both pre-existing in ia-guidelines.md (../content-guidelines.md#…) and unrelated to this change

Screenshots

N/A (no user-facing page changes; redirect only)

Generated with Toshi

base.org/tools/onboarding redirects to docs.base.org/chain/onboarding,
which returns 404. Map it to /get-started/base, matching the existing
/base-chain/tools/onboarding and /chain/onramps redirects.
@mintlify

mintlify Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
base 🟢 Ready View Preview Oct 1, 2026, 8:40 PM

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

@cb-heimdall

Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

This branch was successfully deployed

1 active deployment
staging - docs — 6877e4b2 Deployed Oct 1, 2026 by mintlify[bot]
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