Update get-started.mdx #1677
Merged
Update get-started.mdx #1677
Conversation
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
The product names such as Superchain and Supersim should always be in the format with the first letter capitalized wherever they appear.
✅ Deploy Preview for docs-optimism ready!Built without sensitive environment variables
To edit notification comments on pull requests, go to your Netlify project configuration. |
📝 WalkthroughWalkthroughA capitalization correction was made in the link text within a markdown table on the "pages/interop/get-started.mdx" file. The phrase "Setup supersim guide" was updated to "Setup Supersim guide." No other changes were made to the content or structure of the file. Suggested reviewers
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. 🪧 TipsChatThere are 3 ways to chat with CodeRabbit:
SupportNeed help? Create a ticket on our support page for assistance with any issues or questions. 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
|
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 0
🔭 Outside diff range comments (1)
pages/interop/get-started.mdx (1)
55-55: Typo: “Comprensive” → “Comprehensive”-| [Superchain Dev Console](https://console.optimism.io/?utm_source=op-docs\&utm_medium=docs) | Comprensive tool to build, launch, and grow your app on the Superchain. | +| [Superchain Dev Console](https://console.optimism.io/?utm_source=op-docs\&utm_medium=docs) | Comprehensive tool to build, launch, and grow your app on the Superchain. |
🧹 Nitpick comments (2)
pages/interop/get-started.mdx (2)
33-36: Verb choice in link text is incorrect“Setup” is a noun; the imperative verb form should be “Set up.”
Suggested wording: “Set up Supersim guide” or, more succinctly, “Supersim setup guide.”-| **Local development** | Rapid iteration and testing with Supersim | [Setup Supersim guide](/app-developers/tutorials/supersim) | +| **Local development** | Rapid iteration and testing with Supersim | [Supersim setup guide](/app-developers/tutorials/supersim) |
21-21: Capitalize “Devnet” in H1“Superchain Devnet” is a proper noun in this documentation set and should be capitalized consistently.
-# Build interoperable apps on Superchain devnet +# Build interoperable apps on Superchain Devnet
📜 Review details
Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
pages/interop/get-started.mdx(1 hunks)
🧰 Additional context used
📓 Path-based instructions (1)
`**/*.mdx`: "ALWAYS review Markdown content THOROUGHLY with the following criter...
**/*.mdx: "ALWAYS review Markdown content THOROUGHLY with the following criteria:
- First, check the frontmatter section at the top of the file:
- For regular pages, ensure ALL these fields are present and not empty:
--- title: [non-empty] lang: [non-empty] description: [non-empty] topic: [non-empty] personas: [non-empty array] categories: [non-empty array] content_type: [valid type] ---
- For landing pages (index.mdx or files with ), only these fields are required:
--- title: [non-empty] lang: [non-empty] description: [non-empty] topic: [non-empty] ---
- If any required fields are missing or empty, comment:
'This file appears to be missing required metadata. Please check keywords.config.yaml for valid options and add the required fields manually. You can validate your changes by running:pnpm validate-metadata ```'- 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 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).
- For H1, H2, and H3 headers:
- Use sentence case, capitalizing only the first word.
- Preserve the capitalization of proper nouns, technical terms, and acronyms as defined in the 'nouns.txt' file located in the root directory of the project.
- Do not automatically lowercase words that appear in the 'nouns.txt' file, regardless of their position in the header.
- Flag any headers that seem to inconsistently apply these rules for manual review.
- When reviewing capitalization, always refer to the 'nouns.txt' file for the correct capitalization of proper nouns and technical terms specific to the project.
"
⚙️ Source: CodeRabbit Configuration File
List of files the instruction was applied to:
pages/interop/get-started.mdx
🧠 Learnings (2)
📓 Common learnings
Learnt from: qbzzt
PR: ethereum-optimism/docs#1216
File: pages/stack/interop/security.mdx:136-144
Timestamp: 2025-01-08T11:04:45.361Z
Learning: In the ethereum-optimism/docs repository, sections that are commented out in documentation files are intentionally excluded due to accuracy concerns and should not be suggested for inclusion until the information becomes accurate.
Learnt from: sbvegan
PR: ethereum-optimism/docs#1001
File: pages/builders.mdx:11-12
Timestamp: 2024-10-22T02:58:02.175Z
Learning: Prefer using 'OP Stack' over 'OP Mainnet' in documentation for consistency.
Learnt from: qbzzt
PR: ethereum-optimism/docs#1613
File: public/tutorials/attest.mjs:64-71
Timestamp: 2025-05-24T18:24:46.628Z
Learning: For tutorial and educational code in the ethereum-optimism/docs repository, prioritize simplicity and clarity over production-level robustness. Hardcoded values and simplified error handling are acceptable when they help demonstrate core concepts without unnecessary complexity.
Learnt from: smartcontracts
PR: ethereum-optimism/docs#241
File: public/tutorials/standard-bridge-standard-token.sh:3-6
Timestamp: 2024-06-10T19:38:04.907Z
Learning: User `smartcontracts` has requested that `.mdx` files always be reviewed according to the instructions in the `.yaml` configuration file. This preference should be remembered for future interactions.
Learnt from: smartcontracts
PR: ethereum-optimism/docs#241
File: public/tutorials/standard-bridge-standard-token.sh:3-6
Timestamp: 2024-10-13T07:16:50.980Z
Learning: User `smartcontracts` has requested that `.mdx` files always be reviewed according to the instructions in the `.yaml` configuration file. This preference should be remembered for future interactions.
Learnt from: qbzzt
PR: ethereum-optimism/docs#1390
File: public/tutorials/CustomSuperchainToken.sol:32-38
Timestamp: 2025-02-20T16:55:42.917Z
Learning: In tutorial and example code for the ethereum-optimism/docs repository, prioritize code clarity and simplicity over additional security measures or optimizations, unless they are specifically part of the learning objectives.
pages/interop/get-started.mdx (2)
Learnt from: qbzzt
PR: ethereum-optimism/docs#1525
File: pages/stack/interop/tutorials/upgrade-to-superchain-erc20.mdx:500-503
Timestamp: 2025-04-03T01:38:08.988Z
Learning: Private keys in the "Upgrading ERC20 to SuperchainERC20" tutorial document are test/demo keys intentionally included for educational purposes and do not represent security concerns.
Learnt from: qbzzt
PR: ethereum-optimism/docs#1334
File: pages/stack/interop/tutorials/message-passing.mdx:75-83
Timestamp: 2025-02-10T16:26:24.797Z
Learning: In tutorial documentation, it is acceptable to include well-known test private keys (like Hardhat/Anvil's default keys) as they are specifically meant for testing and development purposes.
⏰ Context from checks skipped due to timeout of 90000ms (4)
- GitHub Check: Redirect rules - docs-optimism
- GitHub Check: Header rules - docs-optimism
- GitHub Check: Pages changed - docs-optimism
- GitHub Check: pr-workflow
🔇 Additional comments (1)
pages/interop/get-started.mdx (1)
1-17: Front-matter looks completeAll required metadata fields (
title,lang,description,topic,personas,categories,content_type) are present and non-empty.
No action needed.
krofax
approved these changes
Jul 7, 2025
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 product names such as Superchain and Supersim should always be in the format with the first letter capitalized wherever they appear.
Description
Tests
Additional context
Metadata