Skip to content

docs: fill CLI reference gaps for data prep and rollout collection#1675

Open
lbliii wants to merge 2 commits into
mainfrom
lbliii/docs-cli-dco-fix
Open

docs: fill CLI reference gaps for data prep and rollout collection#1675
lbliii wants to merge 2 commits into
mainfrom
lbliii/docs-cli-dco-fix

Conversation

@lbliii

@lbliii lbliii commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Summary

Fills documented gaps in the CLI reference and installation pages. All CLI additions were verified against nemo_gym/prompt.py and nemo_gym/rollout_collection.py.

Review feedback addressed

  • Copilot review: clarified that responses_create_params overrides use a shallow merge (dict | overrides in _preprocess_rows_from_config), so nested Hydra overrides replace the entire nested dict rather than deep-merging fields.

Verification

  • npm run check (fern check) passes with 0 errors.

Note: Replaces #1498. That PR's branch (docs/cli-reference-cleanup) could not be rewritten due to branch protection (no force-push/delete); an unsigned commit (91526fce) left DCO failing. This PR uses a single signed commit on lbliii/docs-cli-dco-fix.

- ng_materialize_prompts: full parameter table, example, and note vs
  ng_prepare_data (closes #1347).
- resume_from_cache: params-table entries plus Resume Interrupted Runs
  section (closes #1239).
- Generation parameters: ++responses_create_params.<field> Hydra overrides
  with shallow-merge behavior documented (closes #637).
- PyPI-first installation tab in installation.mdx (closes #1191).
- Mirror CLI reference and installation changes into v0.3.0 stable docs.

Signed-off-by: Lawrence Lane <llane@nvidia.com>
@copy-pr-bot

copy-pr-bot Bot commented Jun 23, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@lbliii lbliii changed the title DCO test docs: fill CLI reference gaps for data prep and rollout collection Jun 23, 2026
@lbliii lbliii marked this pull request as ready for review June 23, 2026 15:20
@github-actions

Copy link
Copy Markdown

@ananthsub ananthsub requested a review from marta-sd June 25, 2026 11:32
@marta-sd

Copy link
Copy Markdown
Contributor

@lbliii In the meantime I refactored CLI in PR #1630 and updated the docs, thus the conflicts. Here's the updated version of the content you prepared: #1741 Note that it should be used for latest / 0.4.0, but not for 0.3.0 (this is new CLI syntax, not available in 0.3.0)

Resolve cli-commands.mdx conflict by adopting main's gym CLI rewrite
and porting doc-gap content (resume interrupted runs, shallow-merge
Hydra note, dataset render vs collate guidance) into the new structure.

Signed-off-by: Lawrence Lane <llane@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants