Skip to content

docs(fern): cut v0.5.0 version train#2970

Open
lbliii wants to merge 3 commits into
mainfrom
lbliii/docs/v0.5-version-train
Open

docs(fern): cut v0.5.0 version train#2970
lbliii wants to merge 3 commits into
mainfrom
lbliii/docs/v0.5-version-train

Conversation

@lbliii

@lbliii lbliii commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

What

Wires up the v0.5.0 · 26.06 GA documentation version train. Config only — the frozen v0.5/pages/ tree lives on docs-archive (companion PR #2969) and is stitched in at build time.

  • versions/v0.5.yml — frozen nav derived from nightly.yml (../.././v0.5/pages/; ../product-docs/ left untouched; 160 content paths)
  • versions/latest.yml — GA alias repointed from the v0.4 tree to the v0.5 tree
  • docs.yml — add the v0.5 version pin (kept v0.4 for permalink stability); repoint the bare site-root default to v0.5; mirror the full v0.4 redirect set for the v0.5 and legacy 0.5 slugs (version-root index rules per the empty-path quirk, :path* and .html fallbacks)
  • .gitignore + the three fern-docs-* workflows — register v0.5=docs-archive
  • docs/fern/Makefile — the local docs-stitch target is hardcoded per-version (not registry-driven like the CI action), so add a v0.5 restore line

Merge order — this PR goes SECOND

Merge after #2969 (the docs-archive snapshot). If this merges first, the publish/CI stitch step fatals with archive ref does not contain docs/fern/versions/v0.5/pages.

Reviewer note — site-root repoint

I repointed the bare /nemo/automodel/ root default from v0.4v0.5, matching how the root pointed at v0.4 when v0.4 was GA. If you'd rather the root land on the auto-bumping latest alias instead, say so and I'll change those two rules.

Validation

make docs-check ARCHIVE_REF=lbliii/docs/v0.5-archive-snapshot
→ Stitched frozen v0.4, v0.5 pages
→ Validated 449 MDX files. fern check: 0 errors, 1 warning (pre-existing product-docs autodoc folder)

🤖 Generated with Claude Code

Wire up the v0.5.0 (26.06) GA docs version:
- add versions/v0.5.yml (frozen nav derived from nightly; ../../ -> ./v0.5/pages/)
- repoint versions/latest.yml GA alias to the v0.5 tree
- add the v0.5 pin to docs.yml versions; repoint the site-root default to v0.5
- mirror the v0.4 redirect set for the v0.5 and legacy 0.5 slugs
- register v0.5=docs-archive in the three fern-docs workflows and .gitignore
- restore v0.5/pages in the local docs-stitch Makefile target

The frozen v0.5/pages tree is not on main (gitignored); it lands on the
docs-archive branch via the companion PR and is stitched in at build time.

Validated with: make docs-check ARCHIVE_REF=lbliii/docs/v0.5-archive-snapshot
(0 errors, 449 MDX files).

Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii lbliii requested review from a team and jgerh as code owners July 8, 2026 18:01
@copy-pr-bot

copy-pr-bot Bot commented Jul 8, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

@jgerh

jgerh commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Verified the files against multiple agent reviews. Here is the summary:

  • docs.yml: Successfully pins the v0.5 version, points the site-root default to v0.5, and mirrors all legacy v0.4 redirect rules for the v0.5 and 0.5 slugs.
  • fern-docs-ci.yml: Correctly registers v0.5=docs-archive in the stitch-fern-versions step to ensure fern check does not fail on archived paths.
  • v0.5.yml and latest.yml: Repoints the /latest alias to the v0.5 tree and uses the correct relative paths (./v0.5/pages/...).
  • Merge Order Confirmation: This PR must be merged second (after the companion docs-archive snapshot PR docs(fern): freeze v0.5.0 GA snapshot for archive stitching #2969) to prevent CI and publish failures.

@jgerh jgerh 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.

Verified against multiple agents. LGTM.

@akoumpa akoumpa added the docs-only With great power comes great responsibility. label Jul 9, 2026
@akoumpa

akoumpa commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

/ok to test 45f4d1d

@akoumpa akoumpa 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.

LGTM

@lbliii lbliii enabled auto-merge (squash) July 10, 2026 13:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-only With great power comes great responsibility.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants