Skip to content

docs(protocol): rewrite the protocol overview for the L2 and drop the stale outdated-docs warning - #2284

Open
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/2282-protocol-overview
Open

docs(protocol): rewrite the protocol overview for the L2 and drop the stale outdated-docs warning#2284
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/2282-protocol-overview

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

The hole, and the fix

home/protocol/index.mdx was a 225-word stub that opened with a warning telling readers the docs "may be outdated" — a permanent negative signal on one of the highest-intent protocol pages, 17 months after the migration it warned about. Its body still described the retired L1 ("based on go-ethereum") and linked two legacy/* pages plus L1 consensus.

Rewritten as a ~740-word overview of the chain that exists today: OP Stack architecture with the two Celo substitutions (EigenDA data availability, token-duality precompile), settlement and the challenger/Security Council roles, fees (below a cent, gas in stablecoins via CIP-64), Mento stablecoins, staking/epochs after the migration (validators → community RPC operators), governance, identity (SocialConnect/ODIS, Self, ERC-8004), and what the protocol is optimized for (mobile users, AI agents). Warning banner deleted.

Per AGENTS.md "one fact, one page": every number is a link to its canonical page (/specs/deployments, /specs/transaction-fees, /specs/eigenda, /specs/token-duality, fee-abstraction guide) rather than a restated value.

What this does NOT do / residual risk

Judgement calls

  • Framed identity through MiniPay/SocialConnect and Self rather than the deleted legacy ODIS pages, consistent with docs: remove the Legacy tab #2280's direction.
  • Did not state the 80/20 fee burn/carbon split: /specs/transaction-fees still marks the final L2 behaviour unconfirmed, so the page links instead of asserting.

Issues

Closes #2282 — all boxes met (banner gone, current-chain overview, canonical links, no legacy links, broken-links green).

Stacking / conflicts

Branched off main. #2280 edits the same file (2-line legacy-link fix); this rewrite supersedes those lines — whichever lands second rebases, resolution is "take the rewrite".

Verification evidence

$ mint broken-links   # on 3ddb86c0
success no broken links found
$ git show :home/protocol/index.mdx | grep -c "may be outdated"
0

Facts asserted on the page were verified earlier in this workstream: 1-second blocks and fee level pinned to the specs pages; maxNumGroupsVotedFor/epoch mechanics per the #2280 review (on-chain); EigenDA/settlement per /specs/eigenda and cel2-architecture.

Remaining ops steps

  • none

Checklist

  • Title is the commit message I want on main
  • mint broken-links green; no legacy or redirect-source links
  • Judgement calls flagged above
  • No secrets in the diff

… stale outdated-docs warning

Closes #2282

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@GigaHierz
GigaHierz requested review from a team as code owners August 25, 2026 11:50
@GigaHierz
GigaHierz requested review from a team, karlb, palango and seolaoh and removed request for a team and seolaoh August 25, 2026 11:50
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: Rewrite the Celo Protocol overview — remove the stale L1 warning banner, describe the current L2

1 participant