105 broken redirect destinations in docs.json (onchainkit, smart-wallet, apps legacy paths)
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 30/100
- Issue type
- Bug
- Clarity
- Needs clarification
- Activity status
- Quiet
- Domain
- documentation
Research direction
Start with docs.json and cross-check each destination against the docs/ tree and navigation, as described in the audit. Ask maintainers to confirm the intended handling of the onchainkit, smart-wallet, base-app, and missing apps destinations before changing redirects. Done means the confirmed broken redirect groups point to valid intended pages or are removed or consolidated.
Written by the indexing model from the issue text.
Description
Description
While auditing docs.json redirects, I found many destination values that point to pages which no longer exist in the docs/ tree. Visitors hitting these legacy URLs get redirected straight into a 404 instead of the intended page.
I verified this by cross-checking every redirect destination against the actual file tree and the docs.json navigation. Two of the highest-impact cases (75 redirects total) are already fixed in the companion PR:
/base-account/basenames/basenames-wagmi-tutorial(39 redirects) -> now points to/base-account/framework-integrations/wagmi/basenames/apps/quickstart/create-new-app(36 redirects) -> now points to/apps/quickstart/build-app
Remaining broken destinations (105 unique, ~270 redirect entries)
The biggest remaining groups, by number of redirects pointing at them:
| Count | Broken destination | Notes |
|---|---|---|
| 94 | /get-started/migrate-from-onchainkit |
Itself redirects to /onchainkit/migrate-from-onchainkit, which also doesn't exist - a broken redirect chain. No docs/onchainkit/ directory exists in this repo, though README.md and claude.md still list onchainkit/ as an established section. Not sure if this content moved to a separate site/repo - needs maintainer input. |
| 13 | /apps/introduction/overview |
No docs/apps/introduction/ directory exists. Possibly should be /apps or /apps/quickstart/build-app. |
| 11 | /smart-wallet/quickstart |
smart-wallet appears fully retired (superseded by base-account), same pattern as ~40 other /smart-wallet/* and /base-app/* destinations. |
| 5 | /apps/core-concepts/manifest |
No core-concepts directory under docs/apps/. |
| 4 | /apps/troubleshooting/how-search-works |
No troubleshooting directory under docs/apps/. |
| 4 | /apps/featured-guidelines/design-guidelines |
No featured-guidelines directory under docs/apps/. |
The remaining ~90 unique destinations are mostly 1-3x each, largely /onchainkit/*, /smart-wallet/*, and /base-app/* legacy paths - consistent with a larger IA migration where redirect sources were kept but destinations were never updated to match final page locations.
Why I'm not fixing these all in one PR
Several of these (especially the /onchainkit/* and /smart-wallet/* groups) look like they may map to content that was intentionally moved out of this repo entirely, rather than just renamed within it. Guessing destinations for ~270 redirect entries without confirming intent risks introducing new incorrect redirects. Flagging here so a maintainer can confirm whether:
- OnchainKit docs moved elsewhere (and these redirects should point external), or
- Should be removed/consolidated if that content is fully retired.
Happy to open follow-up PRs for whichever groups get confirmed.
- Dominant language
- JavaScript
- Stars
- 337
- Forks
- 798
- Avg merge
- 7h 24m
- Merged PRs (30d)
- 51
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from base/docs
-
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
[Block] Latest Posts [Type] Bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
sugarlabs/musicblocks#8847 ·