docs(giga): rework Sei Giga pages for whitepaper v2.0#42
Conversation
- Rewrite learn/sei-giga, sei-giga-specs, and sei-giga-developers from primary sources: Giga whitepaper v2.0 (arXiv 2505.14914v3), the giga.seilabs.io roadmap, and the sei-chain v6.6 release line - Add snippets/giga-diagrams.jsx with 14 theme-aware SVG diagrams - Correct stale Giga executor/storage claims in node/node-operators.mdx (evmone wording, dead evm-ss-* keys, version-scoped defaults) - Update Giga teasers on the home and Learn landing pages, align MCP terminology in the brand kit and llms.txt generator config Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
PR SummaryLow Risk Overview
New Corrections elsewhere: Reviewed by Cursor Bugbot for commit 22d7e43. Bugbot is set up for automated code reviews on this repo. Configure here. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Edit documentation and snippets to adopt future-oriented wording for Sei Giga and unify terminology. Replaces present-tense claims with conditional/future phrasing (use of “will”), renames “Multi-concurrent proposer” to “Multi-Proposer” across pages and diagrams, clarifies Sedna as a private dissemination layer (no traditional public mempool), and tweaks related copy, keywords, and alt text. Also updates the LLMS generator intro and several snippet captions/ARIA labels to match the new phrasing. These are editorial/content updates only.
There was a problem hiding this comment.
A large, well-structured documentation rework of the Sei Giga pages plus 14 new theme-aware inline SVG diagram components; internal links/anchors, referenced pages, CSS variables, and the snippet import convention all check out, and cross-doc config keys are consistent. No blocking issues found; a few non-blocking verification and polish notes remain.
Findings: 0 blocking | 6 non-blocking | 0 posted inline
Blockers
- None at the file/PR level.
Non-blocking
- Review-tooling note: REVIEW_GUIDELINES.md is empty (no repo-specific standards to apply), and both codex-review.md and cursor-review.md are empty — the Codex and Cursor passes produced no output, so this synthesis reflects only my own review.
- External references are unverified: several cited arXiv IDs are future-dated (Sedna 2512.17045, PIVOT-K 2603.17614, Ambulance 2606.25099).
mint broken-linkstypically validates internal links only, so please confirm every external URL (arXiv, blog.sei.io, seiresearch.io, giga.seilabs.io) resolves and points to the intended paper before publishing. - In learn/sei-giga.mdx the roadmap table links both the "Giga whitepaper v1" and "Giga whitepaper v2" rows to the same arXiv abstract (2505.14914); a reader clicking v1 lands on v2. Consider linking /abs/2505.14914v1 for the v1 row (or dropping that link) to avoid confusion.
- snippets/giga-diagrams.jsx GigaMergeRule: the
dup: truefield on V1's txeis defined but never used — the dedup result is hardcoded in the executable-sequence array. Harmless dead data; either drive the strikethrough from it or drop the field. - Brand consistency check: the 14 diagrams use
--sei-maroon-50as a recurring accent throughout. The brand kit (updated in this same PR) restricts maroon/gold to emphasis/legacy use. The usage here reads as emphasis so it's likely fine, but worth a quick design review to confirm it aligns with the stated palette guidance. - Consider a follow-up to run the regenerate-llms workflow post-merge (already called out in the PR description) so llms.txt/llms-full.txt pick up the reworked pages.
Summary
Full rework of the Sei Giga documentation.
Pages rewritten
learn/sei-giga: answer-first overview — architecture in four stages, transaction lifecycle, MEV and fee design, the 11-milestone roadmap with statuses, dated performance tablelearn/sei-giga-specs: complete protocol spec — Autobahn (lanes, f+1 Proofs of Availability, cut-of-tips ordering, 1.5 round trips), the two finality notions, Block-STM OCC, flat storage with LtHash divergence digests, BUD/SuperBUD proofs, Sedna, merge rule and socialised tips, post-quantum path, implementation snapshot, glossary, referenceslearn/sei-giga-developers: what changes for builders — which finality signal per use case, mempool-free submission, three-part fees, parallel-friendly contract patterns, precompile fast-path caveat, prepare-today checklistNew diagrams
snippets/giga-diagrams.jsx: 14 theme-aware inline SVG components (proposer comparison, async pipeline, transaction journey, roadmap track, lanes and cuts, slot pipelining, attestation flow, OCC, storage stack, BUD windows, merge rule, finality signals, fee split, parallelism contrast), each with a caption and aria-labelCorrections elsewhere
node/node-operators.mdx: removed the incorrect "evmone-based executor" description (the engine is Sei's go-ethereum fork; evmone is optional and unused in production), removed the stale Giga Storageapp.tomlexample whoseevm-ss-write-mode/evm-ss-read-modekeys no longer exist (superseded byevm-ss-split), and version-scoped the[giga_executor]defaults (false through v6.5.x; true with OCC from the v6.6 release line)Verification
mint broken-linkspasses; every in-page anchor verifiedPost-merge note: trigger the
regenerate-llms.ymlworkflow sollms.txt/llms-full.txtpick up the new pages.🤖 Generated with Claude Code