Skip to content

docs: add environment concepts pages#1265

Open
cwing-nvidia wants to merge 6 commits intomainfrom
cwing/environment-docs
Open

docs: add environment concepts pages#1265
cwing-nvidia wants to merge 6 commits intomainfrom
cwing/environment-docs

Conversation

@cwing-nvidia
Copy link
Copy Markdown
Contributor

@cwing-nvidia cwing-nvidia commented May 8, 2026

Summary

  • Add Environments concept page — covers environment origins, the four components (dataset, agent harness, verifier, state), and the evaluate-improve loop
  • Add Evaluation concept page — model eval vs. agent eval, evaluation data, and what makes a good eval
  • Add Training concept page — post-training techniques (SFT, RL, GRPO/DAPO/GSPO), how environments are used as reward signal and for synthetic data generation
  • Add evaluate-improve loop and environment-training-library diagrams
  • Update model-vs-agent-eval diagram
  • Update concepts index cards and descriptions
  • Add environment definition to README
  • Add redirect for training-approachestraining
  • Standardize page structure: <Info> component for Goal + Read First, <Cards> for Next Steps

Test plan

  • fern check passes
  • Pages render correctly in Fern preview
  • Diagrams display properly
  • Internal links resolve
  • Redirect from /latest/about/concepts/training-approaches works

@copy-pr-bot
Copy link
Copy Markdown

copy-pr-bot Bot commented May 8, 2026

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

cwing-nvidia and others added 5 commits May 8, 2026 19:20
… index

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…ironment definition to README

- Add Evaluation concept page with model eval vs. agent eval and what makes a good eval
- Restructure concepts index: rename titles (Environments, Evaluation, Agent Harness Optimization, Training)
- Merge training-approaches into upcoming Training page (delete old file, add redirect)
- Add environment definition to README
- Update cross-links in core-components, training-tutorials index

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…ne evaluation and environments pages

Add training.mdx (merged from environments-for-training + training-approaches) covering
post-training techniques (SFT, RL, GRPO/DAPO/GSPO) and how environments are used for
training. Add agent-harness-optimization.mdx. Update environments.mdx heading to
"Anatomy of an Environment". Refine evaluation goal/description. Update index cards.
Replace ASCII diagram with env-training-library image.

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…ions

Add consistent Next Steps sections using Cards format across all four
concept pages. Standardize card descriptions, remove inline tutorial
link from training.mdx, update evaluation goal/description to match
page content, fix agent-harness-optimization to link to eval concept
page instead of tutorials.

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…diagram

Wrap Goal + read-first links in <Info> component across concept pages
for consistent styling with tutorials. Add "Read first" links to
evaluation and training pages. Update model-vs-agent-eval.png with
newer version.

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@cwing-nvidia cwing-nvidia force-pushed the cwing/environment-docs branch from 556dd06 to 77dbb13 Compare May 9, 2026 21:16
Move agent harness optimization concept page to a separate branch
(cwing/agent-harness-optimization-docs) for further research. Remove
all card links and Next Steps references to the page.

Signed-off-by: Chris Wing <cwing@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@cwing-nvidia cwing-nvidia marked this pull request as ready for review May 9, 2026 23:37
@cwing-nvidia cwing-nvidia linked an issue May 9, 2026 that may be closed by this pull request
Comment thread README.md
@@ -4,6 +4,8 @@

NeMo Gym is a library for evaluating and improving models and agents using environments. NeMo Gym provides infrastructure to develop environments, scalably run evaluation and training, and a collection of popular benchmarks and training environments.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

should we also mention nemotron here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I mentioned Nemotron in "What NeMo Gym Provides" - do you think it needs to be mentioned here too?

Comment thread README.md
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.

docs: add environments, evaluation, and training concept pages

2 participants