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
Open
docs(protocol): rewrite the protocol overview for the L2 and drop the stale outdated-docs warning#2284GigaHierz wants to merge 1 commit into
GigaHierz wants to merge 1 commit into
Conversation
… stale outdated-docs warning Closes #2282 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The hole, and the fix
home/protocol/index.mdxwas 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 twolegacy/*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
home/protocol/celo-token.mdx's similar stale warning — Deduplicate migrated Specs pages against the Home and Build guides #2227 owns that page.maintoday; two links get better targets after open PRs merge (phone-number mapping detail → docs(minipay): collapse the section to one Celo-specific overview that routes to docs.minipay.xyz #2271's section; a dedicated Self Agent ID page → docs(agents): add Self Agent ID page under Agent Identity and turn the Self page into a journey #2270) — both work either way.Judgement calls
/specs/transaction-feesstill 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
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/eigendaandcel2-architecture.Remaining ops steps
Checklist
mainmint broken-linksgreen; no legacy or redirect-source links