Skip to content

docs: Finish infra-controller rename accuracy pass#3097

Open
kfelternv wants to merge 5 commits into
NVIDIA:mainfrom
kfelternv:codex/issue-2358-doc-accuracy
Open

docs: Finish infra-controller rename accuracy pass#3097
kfelternv wants to merge 5 commits into
NVIDIA:mainfrom
kfelternv:codex/issue-2358-doc-accuracy

Conversation

@kfelternv

@kfelternv kfelternv commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • align the Quick Start environment requirements, setup options, phase table, and deployed-component list with helm-prereqs/setup.sh
  • migrate all 27 legacy changelog API links to 17 verified routes in the current NVIDIA REST API reference
  • describe the kustomize NICO_TAG path accurately as the NICo Core (nico-core) image and remove the remaining nvmetal-nico Markdown references
  • fix the malformed auth link and three adjacent broken relative documentation links
  • update the in-script Phase 7 summary with NICo Flow and the REST site-agent

Why

The repository rename work in #2357 fixed part of the documentation, but later setup changes left the operator path inconsistent. The Quick Start stopped at Phase 7h without documenting Flow, the site-agent, the current setup flags, or the actual conditional environment requirements. Historical changelog links also continued to point to the old GitHub Pages reference.

This change synchronizes the operator documentation with the current scripts and maps each old API link to its specific maintained destination.

Related issues

Closes #2358

Type of Change

  • Add - New feature or capability
  • Change - Changes in existing functionality
  • Fix - Bug fixes
  • Remove - Removed features or deprecated functionality
  • Internal - Internal changes (refactoring, tests, docs, etc.)

Breaking Changes

  • This PR contains breaking changes

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • Manual testing performed
  • No testing required (docs, internal refactor, etc.)

Verified against upstream main at 8dc207ab25d8aec3001449ab1b5ea440977f05f0:

  • git diff --check — pass
  • bash -n helm-prereqs/setup.sh — pass
  • make -n images-core IMAGE_REGISTRY=registry.example/nico IMAGE_TAG=verify VERSION=verify CI_COMMIT_SHORT_SHA=verify — continues to emit the deliberately renamed local image registry.example/nico/nico:verify
  • deploy/kustomization.yaml maps the Core placeholder to NICO_REGISTRY_PATH/nico-core with NICO_TAG, matching the updated README wording
  • every supported long setup option appears in both setup.sh and the Quick Start
  • stale-string assertions find zero legacy API URLs, infra-controller-core prose, malformed auth URLs, or nvmetal-nico Markdown references
  • all 17 unique changelog destinations are present in NVIDIA's live llms.txt index and return HTTP 200; the corrected auth URL also returns HTTP 200
  • repository rumdl diagnostics across the four primary issue files decrease from 32 on main to 27; no new diagnostics occur on edited lines

Additional Notes

  • Image names belong to distinct paths and are intentionally not collapsed here: local make images produces nico, kustomize uses nico-core, and the currently published Helm/setup artifact remains nvmetal-carbide.
  • Changelog release descriptions remain historical, while their API-reference links now point to the maintained documentation.
  • Existing runtime identifiers such as the ncx-service Keycloak client and /org/ncx/ API examples were intentionally preserved because they still match the implementation.
  • This is a draft fork PR; upstream CI may require the repository's normal /ok-to-test copy workflow before checks run.

@copy-pr-bot

copy-pr-bot Bot commented Jul 2, 2026

Copy link
Copy Markdown

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

coderabbitai Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 3755ce68-38be-429c-8d8a-28d2cd05af0e

📥 Commits

Reviewing files that changed from the base of the PR and between 9801a94 and 52f8d99.

📒 Files selected for processing (2)
  • .gitignore
  • docs/getting-started/quick-start.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/getting-started/quick-start.md

Summary by CodeRabbit

  • Documentation
    • Updated deployment guidance for NICo Core image registry/tag references and clarified environment-variable setup (conditional/optional values, preflight checks, and registry auth).
    • Added documentation for skipping Flow during Phase 7h, including updated Phase/component breakdown and Helm prereqs options.
    • Refreshed NICo REST installation links, improved README formatting, and refreshed REST API changelog URLs/wording.
    • Updated troubleshooting/reference links to current locations.
  • Chores
    • Expanded .gitignore with additional generated directory/file patterns.

Walkthrough

This PR updates documentation across deploy/README.md, docs/getting-started/quick-start.md, helm-prereqs/README.md and setup.sh, rest-api/CHANGELOG.md, and rest-api/deploy/INSTALLATION.md. Changes align NICo branding, correct environment variable requirements per skip flags, document the new NICo Flow phase and --skip-flow option, and repoint stale documentation links.

Changes

Quick-start and prerequisites accuracy pass

Layer / File(s) Summary
NICo Core image reference in deploy README
deploy/README.md
Kustomization input table updated to reference nico-core image path and tag description instead of nvmetal-nico.
Quick-start environment variable and preflight guidance
docs/getting-started/quick-start.md
Step 3a rewritten to clarify optional vs conditional variables (KUBECONFIG, REGISTRY_PULL_SECRET, REGISTRY_PULL_USERNAME) aligned with skip flags; Step 3j preflight wording revised for conditional image-variable validation.
Step 4 command options and phase breakdown
docs/getting-started/quick-start.md
Adds a common options table documenting --skip-core, --skip-rest, --skip-flow, --core-values, --metallb-config, --site-overlay, --debug; splits NICo REST phase breakdown and component tree into base stack, Flow, and site-agent.
Troubleshooting link path fixes
docs/getting-started/quick-start.md
Updates relative paths for the Overall Health Check and OOB network requirements links.
helm-prereqs README and setup.sh Flow phase documentation
helm-prereqs/README.md, helm-prereqs/setup.sh
Documents --skip-flow and flow.enabled=false; reformats deployed components list to add NICo Flow and separate nico-rest-site-agent entries; adds the 7h NICo Flow phase comment in setup.sh.

rest-api documentation link repointing

Layer / File(s) Summary
CHANGELOG API reference link updates
rest-api/CHANGELOG.md
Repoints numerous v1.6.0, v1.5.0, and v1.4.0 entry links from nvidia.github.io/infra-controller-rest to docs.nvidia.com/infra-controller/rest-api-reference.
INSTALLATION.md link path fixes
rest-api/deploy/INSTALLATION.md
Fixes malformed auth documentation link path and updates cli/README.md relative link to a parent-directory path.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Related issues: #2358

Suggested labels: documentation

Suggested reviewers: None specified

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The PR adds unrelated .gitignore ignore patterns that are not part of the documentation rename objectives. Remove the .gitignore additions unless they are required by a separate, explicitly scoped change.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the documentation accuracy pass and infra-controller rename work.
Description check ✅ Passed The description is clearly aligned with the documentation updates and rename cleanup in the PR.
Linked Issues check ✅ Passed The PR addresses the quick-start refresh, Flow/setup flag documentation, changelog link updates, and the malformed auth link from #2358.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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

@kfelternv kfelternv changed the title [codex] docs: finish infra-controller rename accuracy pass docs: Finish infra-controller rename accuracy pass Jul 7, 2026
@kfelternv kfelternv marked this pull request as ready for review July 7, 2026 16:25
@kfelternv kfelternv requested review from a team, polarweasel and shayan1995 as code owners July 7, 2026 16:25
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🔐 TruffleHog Secret Scan

No secrets or credentials found!

Your code has been scanned for 700+ types of secrets and credentials. All clear! 🎉

🔗 View scan details

🕐 Last updated: 2026-07-07 16:29:12 UTC | Commit: 9801a94

@coderabbitai coderabbitai Bot left a comment

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.

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 `@docs/getting-started/quick-start.md`:
- Around line 75-100: The quick-start docs still reference the stale Core image
path in the NICO_IMAGE_REGISTRY description, which conflicts with the current
nico-core naming used elsewhere. Update the copy in this section so the Core
image repository path matches the naming used by deploy/README.md and
helm-prereqs/setup.sh, and keep the examples and table entries consistent with
that corrected path.
🪄 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: feddf27a-3af4-4a5c-a773-11c681c96d62

📥 Commits

Reviewing files that changed from the base of the PR and between 8dc207a and 9801a94.

📒 Files selected for processing (6)
  • deploy/README.md
  • docs/getting-started/quick-start.md
  • helm-prereqs/README.md
  • helm-prereqs/setup.sh
  • rest-api/CHANGELOG.md
  • rest-api/deploy/INSTALLATION.md

Comment thread docs/getting-started/quick-start.md
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🔍 Container Scan Summary

Service Total Critical High Medium Low Other
boot-artifacts-aarch64 3 0 0 3 0 0
boot-artifacts-x86_64 3 0 0 3 0 0
forge-admin-cli-x86_64 271 13 34 91 7 126
machine-validation-runner 776 37 223 281 40 195
machine_validation 776 37 223 281 40 195
machine_validation-aarch64 776 37 223 281 40 195
nvmetal-carbide 776 37 223 281 40 195
TOTAL 3381 161 926 1221 167 906

Per-CVE detail lives in the per-service grype-* artifacts (JSON + SARIF). Severity counts only — no CVE IDs published here.

@kfelternv kfelternv requested review from Coco-Ben and thossain-nv July 7, 2026 16:42
@ajf ajf removed the medium risk label Jul 7, 2026

@thossain-nv thossain-nv left a comment

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.

Thanks for the fixes @kfelternv, one suggestion.

Comment thread docs/getting-started/quick-start.md Outdated
Comment thread docs/getting-started/quick-start.md Outdated
kfelternv added 2 commits July 7, 2026 17:47
Signed-off-by: Kyle Felter <kfelter@nvidia.com>
Signed-off-by: Kyle Felter <kfelter@nvidia.com>
@kfelternv kfelternv requested a review from thossain-nv July 7, 2026 23:07
@kfelternv kfelternv enabled auto-merge (squash) July 8, 2026 00:28
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.

Finish infra-controller rename: quick-start accuracy refresh + remaining markdown files

3 participants