Skip to content

fix(docs): correct broken internal links after restructure#1587

Open
mehmetkr-31 wants to merge 3 commits into
base:masterfrom
mehmetkr-31:fix/broken-internal-links
Open

fix(docs): correct broken internal links after restructure#1587
mehmetkr-31 wants to merge 3 commits into
base:masterfrom
mehmetkr-31:fix/broken-internal-links

Conversation

@mehmetkr-31

Copy link
Copy Markdown

Summary

Resolves 53+ broken internal links introduced by the recent documentation restructure (mini-apps → apps migration, /learn/ content archival, and specs reorganization).

Changes

  • Internal link fixes:

    • /base-chain/quickstart/bridge-token/base-chain/specs/protocol/bridging/deposits
    • /apps/quickstart/create-new-app/apps/quickstart/build-app
    • /ai-agents/guides/agent-builder-codes/ai-agents/quickstart
    • /base-chain/network-information/node-providers/base-chain/node-operators/node-providers
    • /apps/introduction/overview/apps
    • /learn/... (36 links) → https://github.com/base/learn-docs (canonical external archive)
    • /mini-apps/... (3 links) → /apps
    • /base-account/basenames/basenames-wagmi-tutorial → external archive
  • Static content fixes:

    • Remove 8 broken /static/bytecode/... links in protocol specs (ecotone, fjord, isthmus, jovian derivation docs)
    • Add missing <Card title> attributes in flashblocks-api-overview.mdx

Verification

  • node scripts/lint-mdx.js all → "Possibly broken internal link" count: 0 (was 53+)

Impact

Users following internal cross-references no longer hit 404s.

- Update /base-chain/quickstart/bridge-token -> /base-chain/specs/protocol/bridging/deposits
- Update /learn/foundry/deploy-with-foundry -> https://github.com/base/learn-docs
- Update /apps/quickstart/create-new-app -> /apps/quickstart/build-app
- Update /ai-agents/guides/agent-builder-codes -> /ai-agents/quickstart
- Add missing Card titles in flashblocks-api-overview
- Remove broken /static/bytecode/ links in derivation specs
The /learn/ content pages were archived to github.com/base/learn-docs.
This commit updates all 36 broken internal /learn/ links in the
learning-objectives snippet to point to the canonical external archive.
- Update mini-apps archive links to /apps
- Update basenames wagmi tutorial to external archive
- Update apps/introduction/overview -> /apps
- Update node providers path to correct location
- Update deploy-smart-contracts foundry link to external archive
@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

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