docs: complete post-tag audit follow-ups

[miyoungc]

Summary

Complete the documentation fast-follow from the v0.0.86 through v0.0.88 post-tag audits. This adds durable recovery and OpenIB guidance, corrects the v0.0.87 force-install record, and gives platform-specific setup a focused navigation home without duplicating the full DGX Station procedure in generated reference tables.

Changes

• Warn that prepared legacy recovery restores only the manifest-managed state directory and does not preserve paths such as /sandbox/user-data.
• Add the bounded OpenIB disable-or-repair procedure and clarify owning-gateway selection, active-forward proof, and gateway-bound web-search credential reuse.
• Document the temporary v0.0.87 --force-station-install escape hatch with its retained validation boundaries.
• Keep Prerequisites as a page and move Station and Windows procedures into a sibling non-clickable Additional Setup group for all agent variants.
• Add direct redirects for retired Prerequisites child routes and regression coverage for variant-aware and pre-variant URL forms.
• Reduce generated Station duplication while preserving support status, direct-GPU policy boundaries, validation evidence, provider availability, and canonical links.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Quality Gates

• Tests added or updated for changed behavior
• Existing tests cover changed behavior — justification:
• Tests not applicable — justification:
• Docs updated for user-facing behavior changes
• Docs not applicable — justification:
• Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
• Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification:
• Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Verification

• PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
• Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run check:diff passed when hooks were skipped or unavailable
• Targeted behavior tests pass for the current change set, or tests are marked not applicable above — npx vitest run test/changelog-docs.test.ts test/station-doc-ownership.test.ts test/check-docs-published-routes.test.ts test/check-docs-links.test.ts (44 passed)
• Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — command/result: Not run; this is a documentation-only change with focused coverage.
• Quality Gates section completed with required justifications or waivers
• No secrets, API keys, or credentials committed
• npm run docs builds without warnings (doc changes only) — passed with 0 errors and 1 Fern warning
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Miyoung Choi miyoungc@nvidia.com

Summary by CodeRabbit

• Documentation

  • Reorganized platform setup guidance under Additional Setup, with updated links throughout the user documentation.
  • Added DGX Station troubleshooting guidance for failed OpenIB services.
  • Expanded Station Express installation notes, recovery receipt support, and temporary override guidance.
  • Clarified inference provider requirements, model defaults, and NGC authentication.
  • Improved sandbox recovery, rebuild, gateway selection, and legacy backup scope documentation.
  • Added redirects so existing setup links continue to work.

• Bug Fixes

  • Corrected outdated setup and troubleshooting links across release notes and reference pages.

[copy-pr-bot]

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.

[coderabbitai]

📝 Walkthrough

Walkthrough

The PR migrates setup links to Additional Setup routes, adds legacy redirects and ownership tests, expands DGX Station preparation guidance, refreshes platform/provider documentation, and documents sandbox recovery and gateway-selection behavior.

Changes

Documentation and operational guidance

Layer / File(s)	Summary
Setup route migration and redirect coverage docs/changelog/*, docs/get-started/*, docs/index.yml, docs/inference/set-up-vllm.mdx, docs/reference/troubleshooting.mdx, fern/docs.yml, test/station-doc-ownership.test.ts	Setup references now use Additional Setup routes; legacy Prerequisites URLs receive redirect coverage, and ownership tests validate navigation, links, and redirect variants.
Station preparation and onboarding guidance docs/get-started/dgx-station-preparation.mdx, docs/changelog/2026-07-17.mdx	Station preparation documents OpenIB failure checks and remediation, while the changelog records temporary installation override and resume-receipt behavior.
Platform and provider support descriptions ci/platform-matrix.json, docs/inference/choose-inference-provider.mdx, docs/reference/platform-support.mdx	Station status, direct-GPU limits, managed-vLLM defaults, runtime pinning, setup links, and NGC login requirements are updated.
Sandbox recovery and gateway selection docs/manage-sandboxes/recover-rebuild-sandboxes.mdx, docs/reference/commands.mdx	Recovery and rebuild documentation adds gateway ownership checks, managed-state recovery scope, credential-binding validation, and owner-gateway selection for exec and status.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

• NVIDIA/NemoClaw#6883: Updates related Station and managed-vLLM platform/provider descriptions.
• NVIDIA/NemoClaw#7255: Touches the same v0.0.89 changelog documentation link.
• NVIDIA/NemoClaw#7264: Updates related DGX Station Express model and installation documentation.

Suggested labels: chore

Suggested reviewers: ericksoa, senthilr-nv, jyaunches, cv

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the documentation follow-up theme and matches the PR's post-tag audit cleanup work.
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.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/post-tag-audit-fixes

---

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

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-7261.docs.buildwithfern.com/nemoclaw

[github-code-quality]

Code Coverage Overview

Languages: TypeScript

TypeScript / code-coverage/plugin

The overall coverage in commit ae86955 in the docs/post-tag-audit-... branch remains at 96%, unchanged from commit ad26c30 in the main branch.

TypeScript / code-coverage/cli

The overall coverage in commit ae86955 in the docs/post-tag-audit-... branch remains at 80%, unchanged from commit ad26c30 in the main branch.

Show a code coverage summary of the most impacted files.

File	main ad26c30	docs/post-tag-audit-... ae86955	+/-
src/lib/inferen...lama/process.ts	100%	50%	-50%
src/lib/inferen...er-lifecycle.ts	71%	65%	-6%
src/lib/state/m...-acquisition.ts	89%	84%	-5%
src/lib/platform.ts	89%	84%	-5%
src/lib/messagi...nnels/policy.ts	100%	100%	0%
src/lib/sandbox...rce-identity.ts	91%	91%	0%
src/lib/securit...ntial-filter.ts	93%	93%	0%
src/lib/state/m...ock-identity.ts	95%	95%	0%
src/lib/trace.ts	94%	94%	0%
src/lib/tunnel/services.ts	73%	73%	0%

---

_{Updated July 20, 2026 19:30 UTC}

[github-actions]

PR Review Advisor — Informational

Advisor assessment: Informational / low confidence
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions
Status: PR review advisor failed: PR review advisor SDK execution failed: session: omitted required tool result(s): pr_review_metadata, pr_review_response_schema, pr_review_read_ledger; turn: synthesize-json: omitted required tool result(s): pr_review_metadata, pr_review_response_schema, pr_review_read_ledger

Model lanes

• GPT-5.6 Terra (primary): Failed
• Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions

Nemotron output stays in workflow artifacts and does not change the assessment above.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: cloud-onboard

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@fern/docs.yml`:
- Around line 396-419: The flat legacy routes for both DGX Station and Windows
preparation need Markdown-extension redirects and test coverage. In
fern/docs.yml lines 396-419, add .md and .mdx source redirects for both latest
and unversioned prerequisite routes, preserving each extension while targeting
the existing destinations; in test/station-doc-ownership.test.ts lines 125-129,
include .md and .mdx in the flat-route suffix matrix and preserve the suffix in
expected destinations.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: d5c39ebf-9a59-4f11-82d7-ca6f2c927f21

📥 Commits

Reviewing files that changed from the base of the PR and between ad26c30 and ae86955.

📒 Files selected for processing (21)

• ci/platform-matrix.json
• docs/changelog/2026-05-28.mdx
• docs/changelog/2026-06-29.mdx
• docs/changelog/2026-06-30.mdx
• docs/changelog/2026-07-02.mdx
• docs/changelog/2026-07-04.mdx
• docs/changelog/2026-07-17.mdx
• docs/changelog/2026-07-18.mdx
• docs/changelog/2026-07-20.mdx
• docs/get-started/dgx-station-preparation.mdx
• docs/get-started/prerequisites.mdx
• docs/get-started/quickstart.mdx
• docs/index.yml
• docs/inference/choose-inference-provider.mdx
• docs/inference/set-up-vllm.mdx
• docs/manage-sandboxes/recover-rebuild-sandboxes.mdx
• docs/reference/commands.mdx
• docs/reference/platform-support.mdx
• docs/reference/troubleshooting.mdx
• fern/docs.yml
• test/station-doc-ownership.test.ts

[coderabbitai]

🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win

Preserve flat legacy Markdown route forms too.

The variant redirects include .md and .mdx, but flat legacy routes do not. Those URLs bypass these explicit rules, and the test currently cannot catch the gap.

• fern/docs.yml#L396-L419: add .md and .mdx redirects for both retired pages under /nemoclaw/latest/get-started/prerequisites/ and /nemoclaw/get-started/prerequisites/.
• test/station-doc-ownership.test.ts#L125-L129: include .md and .mdx in the flat-route suffix matrix and preserve the extension in expected destinations.

📍 Affects 2 files

• fern/docs.yml#L396-L419 (this comment)
• test/station-doc-ownership.test.ts#L125-L129

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@fern/docs.yml` around lines 396 - 419, The flat legacy routes for both DGX
Station and Windows preparation need Markdown-extension redirects and test
coverage. In fern/docs.yml lines 396-419, add .md and .mdx source redirects for
both latest and unversioned prerequisite routes, preserving each extension while
targeting the existing destinations; in test/station-doc-ownership.test.ts lines
125-129, include .md and .mdx in the flat-route suffix matrix and preserve the
suffix in expected destinations.

Sources: Coding guidelines, Path instructions