Skip to content

[codex] publish 26.06 release notes and migration checklist#2143

Open
lbliii wants to merge 6 commits into
NVIDIA-NeMo:mainfrom
lbliii:codex/docs-26-06-release-notes
Open

[codex] publish 26.06 release notes and migration checklist#2143
lbliii wants to merge 6 commits into
NVIDIA-NeMo:mainfrom
lbliii:codex/docs-26-06-release-notes

Conversation

@lbliii

@lbliii lbliii commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Summary

Publishes the NeMo Curator 26.06 (v1.3.0) release-level documentation rollup tracked by #2120 and the supplemental code-freeze audits in #2118.

Release-boundary update

PR #2063 is now on main, so the branch no longer says resumability is unreleased. The release notes and migration checklist document released Pipeline.run(checkpoint_path=...) behavior, its pre-existing-Ray requirement, local checkpoint storage, resumability-safe stage validation, and NoneTask / FailedTask semantics.

PR #2059 is also included as a new capability: deterministic source sharding across SLURM arrays, shard completion manifests, and incomplete-shard retry discovery.

Supplemental coverage

The update explicitly captures #1427, #1679, #1746, #1762, #1763, #1774, #1844, #1855, #1870, #1880, #1888, #1890, #1895, #1927, #1957, #2059, and #2063. Detailed #1927 guidance is in #2149, native resumability is in #2134, and SLURM arrays are in #2154.

Merge order / documentation dependencies

Merge this PR after the detailed feature workstreams so its canonical internal links resolve to their final pages:

Validation

  • fern check: passed with 0 errors
  • git diff --check: passed
  • all Python examples in the release notes and migration page parse with ast
  • coverage audit: all 17 supplemental/code-freeze PR numbers are linked
  • dependency audit: versions verified against current pyproject.toml, uv.lock, Dockerfile, and HAProxy installer
  • fern docs broken-links: 10 planned sibling-page links above plus the 22 pre-existing repository errors

Closes #2120
Part of #2144
Parent tracker: #2118

@copy-pr-bot

copy-pr-bot Bot commented Jun 30, 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.

lbliii added 2 commits July 1, 2026 14:00
Signed-off-by: Lawrence Lane <llane@nvidia.com>
Signed-off-by: Lawrence Lane <llane@nvidia.com>
Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii lbliii marked this pull request as ready for review July 1, 2026 21:00
@lbliii lbliii requested a review from a team as a code owner July 1, 2026 21:00
@lbliii lbliii requested review from meatybobby and removed request for a team July 1, 2026 21:00
@greptile-apps

greptile-apps Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Publishes the NeMo Curator 26.06 (v1.3.0) release-level documentation: the stale 26.04 index.mdx is replaced with a full 26.06 release notes page, a new 26-06-migration.mdx migration checklist is added, and main.yml is updated to include it in navigation.

  • The migration checklist covers 11 areas (Python upgrade, framework-owned task IDs, sentinel construction, video preprocessing removal, caption variant rename, typed inference-server config, ASR worker rename, stage scheduling normalization, arch-specific deps, resumability, and post-upgrade checks), with before/after code examples for each breaking change.
  • Cross-links between index.mdx and 26-06-migration.mdx use numbered anchor fragments (#4-remove-..., #9-review-...) that match the numbered ## headings in the migration file; the previous review concern about missing number prefixes does not apply to the current diff.
  • Dependency versions cited in the release notes (Ray 2.55.1, vLLM 0.18.1 within >=0.14.1,<0.19, PyTorch 2.10.0+cu129, AI-Dynamo 1.1.0, HAProxy 2.8.20) are internally consistent.

Confidence Score: 5/5

Documentation-only PR; no executable code paths, API contracts, or data migrations are touched.

All three changed files are MDX documentation and a YAML navigation entry. The before/after code examples are syntactically valid Python (verified by ast per the PR description), the cross-page fragment anchors use numbered prefixes that match the numbered headings in the migration file, and the dependency versions cited are internally consistent. No runtime behavior changes.

No files require special attention.

Important Files Changed

Filename Overview
fern/versions/main.yml Adds the 26.06 Migration Checklist page to the Release Notes navigation block; minimal, correct YAML change.
fern/versions/main/pages/about/release-notes/26-06-migration.mdx New 11-section migration checklist covering Python upgrade, task-ID removal, sentinel construction, video preprocessing removal, caption variant rename, typed inference-server config, ASR worker rename, stage scheduling, arch-specific deps, resumability setup, and post-upgrade checks. Frontmatter, before/after code examples, and cross-links look internally consistent.
fern/versions/main/pages/about/release-notes/index.mdx Replaces 26.04 release notes with 26.06 content; includes What's New, Improvements, Fixes, Breaking Changes, Dependency Changes, and Upgrade Checklist sections. Fragment anchors in cross-links use numbered prefixes that match the numbered headings in the migration page.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[User opens Release Notes] --> B[index.mdx — 26.06 Release Notes]
    B --> C{Needs migration?}
    C -->|Yes| D[26-06-migration.mdx — Migration Checklist]
    C -->|No| E[Read What's New / Fixes / Deps]
    D --> D1[1. Upgrade Python to 3.11-3.13]
    D --> D2[2. Stop supplying task_id]
    D --> D3[3. Instantiate EmptyTask]
    D --> D4[4. Remove model_does_preprocess]
    D --> D5[5. Replace qwen variant]
    D --> D6[6. Replace InferenceModelConfig]
    D --> D7[7. Rename num_workers to dataloader_num_workers]
    D --> D8[8. Normalize stage scheduling]
    D --> D9[9. Review arch-specific deps]
    D --> D10[10. Configure Pipeline Resumability]
    D --> D11[11. Run post-upgrade checks]
    D1 & D2 & D3 & D4 & D5 & D6 & D7 & D8 & D9 & D10 & D11 --> Z[Validated pipeline on 26.06]
    B --> F[main.yml navigation]
    F --> G[Release Notes Overview]
    F --> D
    F --> H[Migration FAQ]
Loading
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[User opens Release Notes] --> B[index.mdx — 26.06 Release Notes]
    B --> C{Needs migration?}
    C -->|Yes| D[26-06-migration.mdx — Migration Checklist]
    C -->|No| E[Read What's New / Fixes / Deps]
    D --> D1[1. Upgrade Python to 3.11-3.13]
    D --> D2[2. Stop supplying task_id]
    D --> D3[3. Instantiate EmptyTask]
    D --> D4[4. Remove model_does_preprocess]
    D --> D5[5. Replace qwen variant]
    D --> D6[6. Replace InferenceModelConfig]
    D --> D7[7. Rename num_workers to dataloader_num_workers]
    D --> D8[8. Normalize stage scheduling]
    D --> D9[9. Review arch-specific deps]
    D --> D10[10. Configure Pipeline Resumability]
    D --> D11[11. Run post-upgrade checks]
    D1 & D2 & D3 & D4 & D5 & D6 & D7 & D8 & D9 & D10 & D11 --> Z[Validated pipeline on 26.06]
    B --> F[main.yml navigation]
    F --> G[Release Notes Overview]
    F --> D
    F --> H[Migration FAQ]
Loading

Reviews (5): Last reviewed commit: "docs: add missing 26.06 migration notice..." | Re-trigger Greptile

Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii lbliii force-pushed the codex/docs-26-06-release-notes branch from 303c2a2 to 28712ec Compare July 2, 2026 02:10
Signed-off-by: Lawrence Lane <llane@nvidia.com>
@lbliii

lbliii commented Jul 2, 2026

Copy link
Copy Markdown
Contributor Author

Adversarial release-doc review follow-up is now included in commit 86e286845:

  • Added a What's New entry and breaking-change notice for the expanded Qwen/Nemotron caption model matrix.
  • Added the required migration from the removed qwen caption variant to qwen2.5 or qwen3.
  • Added a What's New entry and breaking-change notice for typed Ray Serve/Dynamo inference-server configuration.
  • Added before/after migration guidance for the removed InferenceModelConfig API.
  • Updated the migration summary, section anchors, and post-upgrade checks.

This makes #2147 and #2148 explicit content dependencies of the release rollup. Please merge the detailed feature PRs first and keep #2143 last so the consolidated 26.06 page can be rebased once and retain all release-note material.

Validation after rebasing on the current remote branch:

  • fern check: 0 errors
  • git diff --check: passed
  • all 15 Python code blocks in the migration checklist parse with ast

Cross-PR integration and publication staging are tracked in #2160.

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.

[Docs] Publish 26.06 release notes and migration checklist

1 participant