Skip to content

docs: Add doc for nano-v3#1694

Merged
terrykong merged 6 commits intomainfrom
yifu/nano-v3-docs
Jan 5, 2026
Merged

docs: Add doc for nano-v3#1694
terrykong merged 6 commits intomainfrom
yifu/nano-v3-docs

Conversation

@yfw
Copy link
Contributor

@yfw yfw commented Dec 24, 2025

What does this PR do ?

Adds instructions for training nano-v3 with nemo rl.

Issues

List issues that this PR closes (syntax):

Usage

  • You can potentially add a usage example below
# Add a code snippet demonstrating how to use this

Before your PR is "Ready for review"

Pre checks:

  • Make sure you read and followed Contributor guidelines
  • Did you write any new necessary tests?
  • Did you run the unit tests and functional tests locally? Visit our Testing Guide for how to run tests
  • Did you add or update any necessary documentation? Visit our Document Development Guide for how to write, build and test the docs.

Additional Information

  • ...

Summary by CodeRabbit

Documentation

  • Added comprehensive guide for post-training Nemotron 3 Nano model using NeMo RL.
  • Includes step-by-step instructions for data preparation, repository setup, launch script configuration with required parameters, and training execution.
  • Details resource requirements and environment configuration.

✏️ Tip: You can customize this high-level summary in your review settings.

Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
@yfw yfw requested a review from a team as a code owner December 24, 2025 01:02
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Dec 24, 2025
@yfw yfw changed the title Add doc for nano-v3 docs: Add doc for nano-v3 Dec 24, 2025
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 24, 2025

📝 Walkthrough

Walkthrough

New documentation file introducing a guide for post-training the Nemotron 3 Nano model using NeMo RL. The guide covers data preparation, repository setup, launch script configuration with resource specifications, and execution instructions.

Changes

Cohort / File(s) Summary
Documentation
docs/guides/nemotron-3-nano.md
New guide file with step-by-step instructions for post-training Nemotron 3 Nano including data setup, NeMo RL repository cloning, launch script creation with environment variables and SLURM configuration, and training execution.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Add doc for nano-v3' is vague and generic, using non-descriptive terms that don't convey the specific content or purpose of the documentation being added. Use a more descriptive title that clarifies what the documentation covers, such as 'Add guide for post-training Nemotron 3 Nano with NeMo RL' to better convey the documentation's scope and purpose.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Test Results For Major Changes ✅ Passed PR contains only documentation changes (71-line instructional guide) with no code modifications, features, or breaking changes.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch yifu/nano-v3-docs

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

Comment @coderabbitai help to get the list of available commands and usage tips.

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: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 669e70c and 08cc727.

📒 Files selected for processing (1)
  • docs/guides/nemotron-3-nano.md
🧰 Additional context used
📓 Path-based instructions (2)
docs/**/*.md

📄 CodeRabbit inference engine (CODING_GUIDELINES.md)

Update docs/index.md when a new markdown doc is added under docs/**/*.md or a markdown file is renamed, ensuring the document appears in the most appropriate section

Files:

  • docs/guides/nemotron-3-nano.md
!(**/tests/**|**/test_*.py|**/test_*.sh)

📄 CodeRabbit inference engine (CODING_GUIDELINES.md)

Add the NVIDIA copyright header to all Python files and shell scripts (excluding tests). The header should include the current year

Files:

  • docs/guides/nemotron-3-nano.md
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
  • GitHub Check: build-container / main
  • GitHub Check: Lint check
  • GitHub Check: Post automodel integration comment / Comment on PR
  • GitHub Check: Post submodule check comment / Comment on PR
🔇 Additional comments (3)
docs/guides/nemotron-3-nano.md (3)

1-71: Verify that docs/index.md has been updated to include this new guide.

Per the coding guidelines, when a new markdown documentation file is added under docs/**/*.md, the docs/index.md file must be updated to ensure the document appears in the most appropriate section. Since this file is not included in the review context, please confirm that it has been updated to reference docs/guides/nemotron-3-nano.md.

🔎 How to verify

Check that docs/index.md contains an entry linking to the new guide. It should appear in a section like "Guides" or similar. For example:

- [Nemotron 3 Nano Post-Training Guide](guides/nemotron-3-nano.md)

64-64: Clarify the ray.sub script reference.

Line 64 references ray.sub without a full path or explanation. This file is not created or described in the documentation. Please clarify whether ray.sub is:

  1. A file that users should have in their repository root
  2. A file provided elsewhere in the NeMo RL repository
  3. Something that needs to be created by the user

Adding a brief explanation or a link to the relevant documentation would improve clarity.


3-71: Documentation content looks solid.

The guide provides clear step-by-step instructions for data preparation, code checkout, launch script configuration, and training execution. The bash commands are syntactically correct, the data splitting logic is sound (using head -n -1000 for training and tail -n 1000 for validation), and the SLURM configuration is well-documented with helpful placeholders.

Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Copy link
Collaborator

@terrykong terrykong left a comment

Choose a reason for hiding this comment

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

nice. can we also have the front page readme news bullet for nano v3 point to this doc?

Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
@yfw yfw requested a review from a team as a code owner December 24, 2025 01:33
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
@yfw
Copy link
Contributor Author

yfw commented Dec 24, 2025

nice. can we also have the front page readme news bullet for nano v3 point to this doc?

Updated the existing bullet point to point to these instructions.

@yfw yfw added the CI:docs Run doctest label Dec 24, 2025
@terrykong terrykong enabled auto-merge (squash) January 5, 2026 18:13
Copy link
Collaborator

@terrykong terrykong left a comment

Choose a reason for hiding this comment

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

@lbliii can you review?

@terrykong terrykong requested a review from lbliii January 5, 2026 18:14
@terrykong
Copy link
Collaborator

@lbliii is out currently, so we'll merge and can always do tech edit afterwards

@terrykong terrykong merged commit 1720466 into main Jan 5, 2026
40 checks passed
@terrykong terrykong deleted the yifu/nano-v3-docs branch January 5, 2026 23:53
parthmannan pushed a commit to parthmannan/RL that referenced this pull request Jan 15, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Signed-off-by: Parth Mannan <pmannan@nvidia.com>
xavier-owkin pushed a commit to owkin/Owkin-NeMo-RL that referenced this pull request Feb 10, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
yuanhangsu1986 pushed a commit to yuanhangsu1986/RL-Nemontron-Edge-Omni that referenced this pull request Feb 12, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Signed-off-by: yuanhangs <yuanhangs@nvidia.com>
yuanhangsu1986 pushed a commit to yuanhangsu1986/RL-Nemontron-Edge-Omni that referenced this pull request Feb 21, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Signed-off-by: yuanhangs <yuanhangs@nvidia.com>
seonjinn pushed a commit that referenced this pull request Mar 8, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
seonjinn pushed a commit that referenced this pull request Mar 8, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
seonjinn pushed a commit that referenced this pull request Mar 9, 2026
Signed-off-by: Yi-Fu Wu <yifu.wu@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI:docs Run doctest documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants