docs.json contains redirects to non-existent internal destinations
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 55/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Quiet
- Domain
- documentation
Research direction
Start in docs/docs.json at the redirect entries around lines 1101, 1261, 1785, 2149, 3045, then compare each destination with the current files under docs/base-account/basenames, the Apps quickstart pages, and ai-agents/payments. Audit the listed redirects and update stale destinations or identify missing pages; done means every internal redirect resolves to an existing docs route.
Written by the indexing model from the issue text.
Description
Summary
docs/docs.json appears to contain multiple redirects whose internal destinations do not exist in the current docs source.
Examples
/get-started/migrate-from-onchainkit
Many OnchainKit redirects point to this destination, but I could not find a corresponding docs page.
Example lines:
docs/docs.json:1261docs/docs.json:1265docs/docs.json:1269docs/docs.json:1273
/base-account/basenames/basenames-wagmi-tutorial
Several Basenames redirects point to this destination, but docs/base-account/basenames/ currently only contains:
- basename-transfer.mdx
- basenames-faq.mdx
Example lines:
docs/docs.json:1101docs/docs.json:1105docs/docs.json:1109
/apps/quickstart/create-new-app
This route does not appear to exist. The current Apps quickstart page seems to be:
/apps/quickstart/build-app
Example lines:
docs/docs.json:1785docs/docs.json:2149docs/docs.json:2153
/ai-agents/payments/x402-protocol
Referenced at:
docs/docs.json:3045
But the current payment pages appear to be:
- ai-agents/payments/pay-for-services-with-x402.mdx
- ai-agents/payments/accepting-payments.mdx
Expected behavior
All internal redirect destinations should resolve to existing docs routes.
Suggested fix
Audit docs.json redirects and update stale destinations to current route names, or restore the missing destination pages where appropriate.
Impact
Broken migration redirects can send users from old docs URLs to 404 pages, especially after docs restructures.
- Dominant language
- JavaScript
- Stars
- 337
- Forks
- 798
- Avg merge
- 13h 7m
- Merged PRs (30d)
- 57
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 92/100
-
Difficulty 1/5 Under an hour Newbie friendliness 92/100
-
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
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
antfu-collective/icones#398 ·
-
ECmail.com Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
wesbos/burner-email-providers#554 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
radiantearth/stac-browser#1023 ·
-
HMR stops working Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
components-web-app/docs#92 ·