-
Notifications
You must be signed in to change notification settings - Fork 194
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update rollup.mdx #1018
Update rollup.mdx #1018
Conversation
updated standard config to match the configurability spec
✅ Deploy Preview for docs-optimism ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
WalkthroughThe changes in this pull request involve significant updates to the Changes
Possibly related issues
Possibly related PRs
Suggested reviewers
Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media? 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments. CodeRabbit Commands (Invoked using PR comments)
Other keywords and placeholders
Documentation and Community
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 0
🧹 Outside diff range and nitpick comments (4)
pages/builders/chain-operators/configuration/rollup.mdx (4)
266-266
: Update standard configuration requirement for clarity.The standard configuration requirement for
l2BlockTime
states "1 or 2 seconds" without explaining the rationale. Consider adding context about why these specific values are required for standard configuration.-* **Standard Config Requirement:** 1 or 2 seconds +* **Standard Config Requirement:** 1 or 2 seconds. These values ensure optimal balance between transaction throughput and network synchronization.
Line range hint
14-24
: Improve callout formatting and clarity.The warning callout about rollup configuration being a work in progress could be more specific about which aspects are likely to change.
- The Rollup configuration is an active work in progress and will likely evolve - significantly as time goes on. If something isn't working about your - configuration, you can refer to the [source code](https://github.com/ethereum-optimism/optimism/blob/develop/op-chain-ops/genesis/config.go). + The Rollup configuration is actively evolving with new protocol upgrades and features. + Some parameters may be added, modified, or deprecated in future releases. For the most + up-to-date configuration details, refer to the [source code](https://github.com/ethereum-optimism/optimism/blob/develop/op-chain-ops/genesis/config.go).
Line range hint
673-688
: Enhance deprecated fields documentation.The deprecated fields section should include migration guidance for users who are still using these fields.
### Deprecated *** #### (**DEPRECATED**) gasPriceOracleScalar GasPriceOracleScalar represents the initial value of the gas scalar in the -GasPriceOracle predeploy. Deprecated: Since Ecotone, this field is superseded -by GasPriceOracleBaseFeeScalar and GasPriceOracleBlobBaseFeeScalar. +GasPriceOracle predeploy. Deprecated: Since Ecotone, this field is superseded by +GasPriceOracleBaseFeeScalar and GasPriceOracleBlobBaseFeeScalar. To migrate, +transfer your existing scalar value to GasPriceOracleBaseFeeScalar and configure +GasPriceOracleBlobBaseFeeScalar separately for blob fee calculations.
Line range hint
504-520
: Clarify Alt-DA Mode documentation.The Alt-DA Mode section should provide more context about the security implications and trade-offs of using alternative data availability solutions.
### Alt-DA Mode Alt-DA Mode enables seamless integration of various Data Availability (DA) -Layers, regardless of their commitment type, into the OP Stack. This allows -any chain operator to launch an OP Stack chain using their favorite DA Layer -for sustainably low costs. Learn more [here](/stack/beta-features/alt-da-mode). +Layers into the OP Stack. This feature allows chain operators to optimize for +cost by choosing alternative DA solutions, with different security and +decentralization trade-offs compared to using Ethereum for DA. Before implementing, +carefully evaluate these trade-offs. Learn more [here](/stack/beta-features/alt-da-mode).
📜 Review details
Configuration used: .coderabbit.yaml
Review profile: CHILL
📒 Files selected for processing (1)
- pages/builders/chain-operators/configuration/rollup.mdx (1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
pages/builders/chain-operators/configuration/rollup.mdx (1)
Pattern
**/*.mdx
: "ALWAYS review Markdown content THOROUGHLY with the following criteria:
- Use proper nouns in place of personal pronouns like 'We' and 'Our' to maintain consistency in communal documentation.
- Avoid gender-specific language and use the imperative form.
- Monitor capitalization for emphasis. Avoid using all caps, italics, or bold for emphasis.
- Ensure proper nouns are capitalized in sentences.
- Apply the Oxford comma.
- Use proper title case for headers, buttons, tab names, page names, and links. Sentence case should be used for body content and short phrases, even in links.
- Use correct spelling and grammar at all times (IMPORTANT).
- Use sentence case for H1, H2, and H3 headers, capitalizing only the first word and any proper nouns.
- For all headers (H1, H2, H3), do not change the capitalization of proper nouns; keep them as they are.
"
🔇 Additional comments (1)
pages/builders/chain-operators/configuration/rollup.mdx (1)
Line range hint
1-700
: LGTM! Documentation structure and technical content are well-organized.The documentation provides comprehensive coverage of configuration parameters with clear descriptions, types, default values, and standard configuration requirements. The organization into logical sections makes it easy to navigate.
updated standard config to match the configurability spec
Description
Tests
Additional context
Metadata