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, and align the optimizer page title with its Run the Agent Optimizer sidebar label.

Changes

• Replace the linked Optimize Agents page node with an expandable section.
• Nest Run the Agent Optimizer and Insight-Driven Optimization beneath that section.
• Apply Run the Agent Optimizer to the optimizer page title as well as its sidebar label.
• 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, publication state, and page metadata; 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.
• Full repository pre-commit suite using repository-compatible uv 0.9.17 and the worktree .venv — passed all hooks, including Studio lint-staged.
• Repository DCO audit — passed for all three commits in the PR range.
• git diff --check origin/main...HEAD — passed.

[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	31438/40061	78.5%	63.0%
Integration Tests	18310/38013	48.2%	20.8%

[coderabbitai]

📝 Walkthrough

Walkthrough

The Agents navigation now groups the Agent Optimizer and Insight-Driven Optimization pages under Optimize Agents. The gated navigation entry was removed. The Agent Optimizer page title now reads “Run the Agent Optimizer.”

Changes

Agents navigation

Layer / File(s)	Summary
Group published optimization pages docs/fern/versions/latest.yml, docs/fern/gated-nav.yml, docs/agents/optimization.mdx	The latest navigation groups both optimization pages under Optimize Agents. The gated navigation entry was removed. The page title was updated to “Run the Agent Optimizer.”

Possibly related PRs

• NVIDIA-NeMo/nemo-platform#1014: Modified the same Insight-Driven Optimization navigation entries.
• NVIDIA-NeMo/nemo-platform#1070: Updated content in the same documentation area.

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 and concisely describes publishing the Insight-Driven Optimization guide, which is the main change.

✨ 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.}

[coderabbitai]

Note

GitHub couldn't provide a complete incremental comparison for this pull request, so CodeRabbit is performing a full review instead. This review may take a little longer.