docs: publish insight-driven optimization guide

[miyoungc]

Summary

Publish the Insight-Driven Optimization guide in the Latest documentation navigation. Group it with the existing optimizer how-to beneath an expandable Optimize Agents node so readers can distinguish the two optimization workflows.

Changes

• Replace the linked Optimize Agents page node with an expandable section.
• Nest Run the Agent Optimizer and Insight-Driven Optimization beneath that section.
• Remove the Insight-Driven Optimization reference from the gated navigation file so Fern builds and serves the guide.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with documentation updates
• Documentation only
• Contributor tooling or automation
• CI, build, or test infrastructure

Quality Gates

• Tests added or updated for changed behavior
• Existing tests cover changed behavior — justification:
• Tests not applicable — justification: This change only updates Fern navigation labels and publication state; the documentation checks validate that behavior.
• Documentation updated for user-visible behavior
• Documentation not applicable — justification:

Verification

• Pull request title follows the repository's Conventional Commit format
• Every commit includes an appropriate Signed-off-by: trailer
• uv run pre-commit run -a passes, or any blocked checks are identified below
• Targeted tests pass, or tests are marked not applicable above
• No secrets, API keys, or credentials are included

Targeted validation:

• make docs-check — passed with 0 Fern errors; 216 MDX files parsed cleanly.
• make docs-broken-links — completed and reported five existing unrelated broken links in telemetry/privacy, authentication, and Studio pages; none target either optimization guide.
• Repository pre-commit suite using the repository-compatible uv 0.9.17 and the worktree .venv — passed all hooks, including Studio lint-staged.
• Repository DCO audit — passed for both commits in the PR range.
• git diff --check — passed.

Summary by CodeRabbit

• Documentation
  • Updated the Agents navigation to group optimization resources under an Optimize Agents section.
  • Added Insight-Driven Optimization and Agent Optimizer pages to the navigation.
  • Removed outdated gated navigation entries and comments.

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-1124-publish-insight-optimization-docs-miyou.docs.buildwithfern.com/nemo-platform

[github-actions]

Suite	Lines Covered	Line Rate	Branch Rate
Unit Tests	31436/40061	78.5%	63.0%
Integration Tests	18308/38013	48.2%	20.8%

[coderabbitai]

📝 Walkthrough

Walkthrough

The Agents navigation now groups Agent Optimizer and Insight-Driven Optimization under an Optimize Agents section. The gated Insight-Driven Optimization navigation block was removed.

Changes

Agents navigation

Layer / File(s)	Summary
Group published optimization pages docs/fern/versions/latest.yml, docs/fern/gated-nav.yml	The latest navigation adds an Optimize Agents section with both optimization pages. The gated navigation removes the Insight-Driven Optimization block.

Possibly related PRs

• NVIDIA-NeMo/nemo-platform#1014: Added the same Insight-Driven Optimization navigation entries.

Suggested reviewers: jeremysilva1098, nicot

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: publishing the Insight-Driven Optimization guide in the latest documentation navigation.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch publish-insight-optimization-docs/miyoungc

---

_{Comment @coderabbitai help to get the list of available commands.}