docs-version-sync: source stack versions from GitHub instead of GitLab
@sbaum1994 is already working on this.
Since Sep 10, 2026.
- Dominant language
- Go
- Stars
- 218
- Forks
- 72
- Avg merge
- 1d 12h
- Merged PRs (30d)
- 427
Description
Objective
Keep the top-of-tree documentation catalog aligned with the latest stable self-managed stack release from the public NVIDIA/nvcf repository. Public artifact availability remains a separate, explicit decision because NGC publication occurs after QA qualification.
Current flow
- The stack release workflow resolves the control-plane, compute-plane, and observability Helmfile states from the exact tagged commit.
- The workflow attaches
nvcf-self-managed-stack-inventory.jsonto the GitHub stack release. tools/docs-version-syncselects the latest stabledeploy/stacks/self-managed/vX.Y.ZGitHub release, downloads that inventory, and validates its tag, commit, and effective stack pins.- The catalog maps resolved artifacts to public catalog destinations. Exact available versions are recorded in
publications; unavailable versions are recorded inpublication_pendingand never render private locations. - The tool updates
docs/version-catalog/main.yamland the generated blocks in the top-of-tree user docs.
The release inventory must exist before the docs catalog can advance. Public NGC publication can happen later. When QA publishes an artifact, update its exact public availability record separately.
Commands
Update the catalog and generated documentation:
go run -C tools/docs-version-sync . --target main --update-catalog
Run the offline consistency check:
./tools/ci/check-doc-version-sync
Compare the checked-in catalog with the latest stable GitHub stack release:
./tools/ci/check-doc-version-current-release
Work tracking
Implementation tasks are attached directly as sub-issues. The final terminology and dead-code cleanup is tracked by #1812.
Completion criteria
- A fresh public GitHub checkout can update the catalog without private source-control inputs.
- The generated catalog covers all three deployment bundles and their resolved artifacts from one immutable stack release.
- Generated docs contain only public catalog locations or
Publication pending. - Offline and current-release checks enforce catalog freshness in GitHub CI.
By submitting this issue, you acknowledge that you are an assigned member of the NVCF development team and agree to follow our code of conduct and our contributing guidelines.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.