You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As a developer (or an AI engine) asking "how does the Celo protocol work", I want the protocol overview to answer with a current, quotable description of the L2 — instead of a 225-word stub that opens by warning me the docs may be outdated.
Context & evidence
Measured at origin/main today:
home/protocol/index.mdx is 225 words and opens with a Warning banner: "As of block height 31,056,500 … Celo is no longer a standalone Layer 1 blockchain … Some documentation may be outdated as updates are in progress." The migration completed in March 2025 — the banner is a permanent negative freshness signal on one of the highest-intent pages, and its CTA points at /build#celo-l2-mainnet, a redirect-era path.
The body still describes the retired L1: "Celo's blockchain reference implementation is based on go-ethereum", and the "Protocol Upgrades" list links two legacy/* pages (being deleted in docs: remove the Legacy tab #2280) plus "Consensus" — an L1 concept.
This page is a prime target for protocol-level AI/search queries; a recent GEO re-audit scored the docs' content quality up sharply overall but flagged exactly this page (short, stale-warning) as the remaining weak signal.
Acceptance criteria
Warning banner removed; no "may be outdated" language anywhere on the page
Page expanded to a real overview (~800 words) written for the current chain: Ethereum L2 on the OP Stack, EigenDA data availability, 1-second blocks, settlement to Ethereum; fee abstraction (CIP-64, gas in stablecoins); Mento stablecoins; staking/epochs and governance; identity (Self, SocialConnect); security roles (sequencer, challengers, Security Council)
Numbers and addresses are linked to their canonical pages, not restated (per AGENTS.md "one fact, one page": /specs/deployments, /specs/transaction-fees, /build-on-celo/fee-abstraction/overview, …)
celo.org marketing pages, Wikipedia/Wikidata entity work (tracked outside this repo); the JSON-LD schema work (separate issue); rewriting home/protocol/celo-token.mdx's stale warning (#2227 owns that page's trim).
Depends on / blocks
None hard. Touches a file #2280 also edits (2-line link fix) — whichever lands second rebases; the rewrite supersedes those lines.
User story
As a developer (or an AI engine) asking "how does the Celo protocol work", I want the protocol overview to answer with a current, quotable description of the L2 — instead of a 225-word stub that opens by warning me the docs may be outdated.
Context & evidence
Measured at
origin/maintoday:home/protocol/index.mdxis 225 words and opens with aWarningbanner: "As of block height 31,056,500 … Celo is no longer a standalone Layer 1 blockchain … Some documentation may be outdated as updates are in progress." The migration completed in March 2025 — the banner is a permanent negative freshness signal on one of the highest-intent pages, and its CTA points at/build#celo-l2-mainnet, a redirect-era path.legacy/*pages (being deleted in docs: remove the Legacy tab #2280) plus "Consensus" — an L1 concept.Acceptance criteria
/specs/deployments,/specs/transaction-fees,/build-on-celo/fee-abstraction/overview, …)legacy/*(deleted by docs: remove the Legacy tab #2280) or other redirect sourcesmint broken-linksgreenNon-goals
celo.org marketing pages, Wikipedia/Wikidata entity work (tracked outside this repo); the JSON-LD schema work (separate issue); rewriting
home/protocol/celo-token.mdx's stale warning (#2227 owns that page's trim).Depends on / blocks
None hard. Touches a file #2280 also edits (2-line link fix) — whichever lands second rebases; the rewrite supersedes those lines.