Skip to content

fix: da tutorials #580

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

fix: da tutorials #580

wants to merge 3 commits into from

Conversation

pthmas
Copy link
Contributor

@pthmas pthmas commented Jun 27, 2025

Overview

Summary by CodeRabbit

  • Documentation
    • Updated tutorials to reference the "gm-world" tutorial instead of "quick start", and switched CLI tool usage from rollkit to gmd.
    • Revised command examples and flag naming conventions in tutorials for consistency and clarity.
    • Updated sidebar by removing the "Use Ignite to create a Rollkit app" entry under "How To Guides".

Copy link
Contributor

coderabbitai bot commented Jun 27, 2025

Walkthrough

The updates remove the "Use Ignite to create a Rollkit app" guide from the sidebar and revise tutorials to reference the "gm-world" tutorial instead of "quick start," update CLI usage from rollkit to gmd, and adjust command-line flag formats and parameters for rollup node commands.

Changes

File(s) Change Summary
.vitepress/config.ts Removed "Use Ignite to create a Rollkit app" from the "How To Guides" sidebar.
tutorials/da/celestia-da.md Updated tutorial to use "gm-world" as a prerequisite, switched CLI tool from rollkit to gmd, and updated flag formats and aggregator flag. Added link to Celestia light node docs.
tutorials/da/local-da.md Changed rollup node command: updated aggregator flag and removed sequencer rollup ID parameter.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Tutorial
    participant CLI (gmd)
    participant Rollup Node

    User->>Tutorial: Follow updated instructions (gm-world, gmd)
    Tutorial->>User: Provide gmd commands with new flags
    User->>CLI (gmd): Execute updated start command
    CLI (gmd)->>Rollup Node: Start rollup node with new aggregator flag
Loading

Possibly related PRs

Suggested reviewers

  • tac0turtle
  • Manav-Aggarwal
  • gupadhyaya

Poem

From sidebar hops, a guide did fade,
And "gmd" commands now lead the parade.
Flags with dots, not underscores,
Tutorials updated—no open doors
To old quick starts, just "gm-world" lore.
🐇✨ Let’s leap ahead, explore some more!


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between bfe5006 and 97c5031.

📒 Files selected for processing (1)
  • tutorials/da/celestia-da.md (3 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • tutorials/da/celestia-da.md

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.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need 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)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

github-actions bot commented Jun 27, 2025

PR Preview Action v1.6.1

🚀 View preview at
https://rollkit.github.io/docs-preview/pr-580/

Built to branch main at 2025-07-02 15:14 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary of Changes

Hello @pthmas, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request cleans up the documentation by removing a stale link in the sidebar menu and removing an unnecessary flag from a command in the local DA tutorial, improving the user experience.

Highlights

  • Menu Update: Removed the 'Use Ignite to create a Rollkit app' link from the 'How To Guides' section in the sidebar configuration.
  • Tutorial Update: Removed the --rollkit.sequencer_rollup_id gmd flag from the example command in the local-da.md tutorial.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request removes a guide from the sidebar configuration and a command-line argument from the local DA tutorial. It's important to verify the reasons for these removals and ensure no functionality is broken.

@pthmas pthmas force-pushed the pierrick/fix-tutorials branch from 5d4590f to 6836fde Compare July 2, 2025 13:33
@pthmas pthmas force-pushed the pierrick/fix-tutorials branch from f1a20db to bfe5006 Compare July 2, 2025 14:41
@pthmas pthmas marked this pull request as ready for review July 2, 2025 14:43
@pthmas pthmas changed the title fix: tutorials fix: da tutorials Jul 2, 2025
Copy link
Contributor

@coderabbitai coderabbitai bot left a 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

♻️ Duplicate comments (1)
tutorials/da/local-da.md (1)

38-41: Aggregator flag updated, but removed sequencer flag—double-check behavioural change

--rollkit.node.aggregator replaces --rollkit.aggregator, and the earlier --rollkit.sequencer_rollup_id gmd line is now gone. Ensure the sequencer flag really became obsolete; if not, note where it is now configured to prevent silent mis-configuration.

🧹 Nitpick comments (2)
tutorials/da/celestia-da.md (2)

47-47: Clarify which binary installs gmd

Readers coming from older material may still have rollkit on their PATH. A short reminder that gmd is installed by running make install in the gm-world tutorial (or the exact command) avoids confusion.


133-138: Explain the purpose of --rollkit.node.aggregator

Dropping a bare boolean flag with no context may confuse newcomers (is it mandatory? why?). Adding a one-sentence comment, e.g. “The flag turns the node into the block aggregator; omit it if you run a non-aggregator node,” would tighten up the tutorial.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b1a4265 and bfe5006.

📒 Files selected for processing (3)
  • .vitepress/config.ts (0 hunks)
  • tutorials/da/celestia-da.md (3 hunks)
  • tutorials/da/local-da.md (1 hunks)
💤 Files with no reviewable changes (1)
  • .vitepress/config.ts
🧰 Additional context used
🧠 Learnings (1)
tutorials/da/local-da.md (2)
Learnt from: assafmo
PR: rollkit/docs#390
File: guides/assets/hyperlane-use-tia-for-gas/relayer.json:1-5
Timestamp: 2024-10-11T19:05:20.591Z
Learning: In the file `guides/assets/hyperlane-use-tia-for-gas/relayer.json`, the settings `"allowLocalCheckpointSyncers": "true"` and `"gasPaymentEnforcement": [{ "type": "none" }]` are intentional.
Learnt from: assafmo
PR: rollkit/docs#390
File: guides/assets/hyperlane-use-tia-for-gas/relayer.json:1-5
Timestamp: 2024-10-08T09:25:31.642Z
Learning: In the file `guides/assets/hyperlane-use-tia-for-gas/relayer.json`, the settings `"allowLocalCheckpointSyncers": "true"` and `"gasPaymentEnforcement": [{ "type": "none" }]` are intentional.
🔇 Additional comments (2)
tutorials/da/celestia-da.md (2)

12-12: Verify link accuracy after quick-start → gm-world switch

/tutorials/gm-world looks correct, but please double-check that the page exists and the anchor IDs referenced from this tutorial still resolve, otherwise users will 404 at the very first step.


53-58: Flag names updated → confirm they match the current binary

The doc now uses the dotted notation (--rollkit.da.*). Make sure every released gmd tag listed in constants.js actually exposes these flags; older nightly builds still expect the underscore form.

@pthmas pthmas requested review from alpe, tac0turtle and julienrbrt July 2, 2025 15:13
@pthmas pthmas force-pushed the pierrick/fix-tutorials branch from bfe5006 to 97c5031 Compare July 2, 2025 15:14
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.

1 participant