Skip to content

docs: rename the Home tab to Learn and move home/ to learn/ - #2367

Open
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/2258-learn-tab
Open

GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/2258-learn-tab

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

Closes #2258

The "Home" tab is now Learn. home/* moves to learn/*, the two protocol-reference pages that sat in the builder tab move in with it, and every old URL redirects to its new home.

What moved

  • 42 pages: home/<path> to learn/<path>, same sub-paths (for example home/protocol/governance/overview is now learn/protocol/governance/overview).
  • Wrong-tab fix: build-on-celo/network-overview to learn/network/overview, and build-on-celo/cel2-architecture to learn/network/architecture.
  • Nav groups in the Learn tab: Introduction, Network, Protocol, Governance, Transactions, Staking, Epoch Rewards, Bridging, and a new "Using CELO" group (wallets, exchanges, ramps, gas fees, self-custody, ReleaseGold, asset management). Every page is listed exactly once; the two moved pages are removed from the Build tab.
  • .github/CODEOWNERS: /home/ and /home/protocol/ become /learn/ and /learn/protocol/, so the blockchain and primitives teams keep ownership.
  • AGENTS.md: content directories and the canonical-page table now use the new paths.

Redirects (all in docs.json)

  • Added /home to /learn and the catch-all /home/:slug* to /learn/:slug*, so home/celo and every other old page redirect without a per-file override (the paths are 1:1 below learn/).
  • Added exact entries for the two moved build-on-celo pages.
  • Retargeted every existing redirect that pointed at /home/... or at the two moved pages straight to the new paths, so there are no two-hop chains. This includes the wildcard ones (/about-celo/:slug*, /what-is-celo/using-celo/*).
  • Removed the old /learn/:slug* to /home/:slug* wildcard. With real /learn/... pages it would shadow them and loop. The explicit /learn/<old-slug> redirects stay, retargeted.
  • Updated 50 files of inbound links (every /home/... link and the two moved pages).

Verification

$ mint broken-links --check-redirects
success no broken links found
$ bash scripts/check-orphans.sh
No orphan pages found.

Under mint dev, 15 old URLs all redirect in one step to the new path, for example /home/protocol/celo-token, /home/manage/exchange, /build-on-celo/network-overview, /about-celo/protocol, /learn/why-celo, and every new learn/... URL returns 200. The tab bar reads Learn, Build on Celo, Tooling, Contribute to Celo, Operate.

Not in this PR

Blocks #2261.

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested review from a team as code owners October 2, 2026 12:55
@GigaHierz
GigaHierz requested review from ezdac and karlb and removed request for a team October 2, 2026 12:55

This branch has not been deployed

No deployments
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.

story: Learn tab — move home/* (plus kept L1 content) to learn/*

1 participant