docs(recipe): use canonical Nemotron model order

Signed-off-by: Chen Cui <chcui@nvidia.com>

Author: cuichenx

docs/_static/model-verification/catalog-v1.json

@@ -67,21 +67,21 @@
 "./versions/nightly/pages/models/gemma/gemma3-vl.mdx": 4
 "./versions/nightly/pages/models/glm/glm5.mdx": 4
 "./versions/nightly/pages/models/glm/glm5-2.mdx": 5
-"./versions/nightly/pages/models/nemotron/nemotron3-super.mdx": 5
+"./versions/nightly/pages/models/nemotron/nemotron3-super.mdx": 6
 "./versions/nightly/pages/models/qwen/qwen2.5-vl.mdx": 6
 "./versions/nightly/pages/nemo2-migration-guide.mdx": 4
 "./versions/nightly/pages/releases/changelog.mdx": 4
 "./versions/nightly/pages/training/training-loop-settings.mdx": 4
 "./versions/nightly/pages/megatron-lm-to-megatron-bridge.mdx": 5
 "./versions/nightly/pages/models/gemma/gemma4-vl.mdx": 5
 "./versions/nightly/pages/models/gemma/index.mdx": 5
-"./versions/nightly/pages/models/nemotron/nemotron3.5-lightning.mdx": 6
-"./versions/nightly/pages/models/nemotron/nemotron-nano-v2-vl.mdx": 7
+"./versions/nightly/pages/models/nemotron/nemotron3.5-lightning.mdx": 8
+"./versions/nightly/pages/models/nemotron/nemotron-nano-v2-vl.mdx": 11
 "./versions/nightly/pages/models/qwen/qwen3-vl.mdx": 7
 "./versions/nightly/pages/releases/known-issues.mdx": 5
 "./versions/nightly/pages/training/optimizer-scheduler.mdx": 5
 "./versions/nightly/pages/models/glm/index.mdx": 6
-"./versions/nightly/pages/models/nemotron/nemotron-3-omni.mdx": 8
+"./versions/nightly/pages/models/nemotron/nemotron-3-omni.mdx": 5
 "./versions/nightly/pages/models/qwen/qwen3.6-35b-a3b.mdx": 8
 "./versions/nightly/pages/models/qwen/qwen3.8-27b.mdx": 9
 "./versions/nightly/pages/training/logging.mdx": 6
@@ -118,3 +118,6 @@
 "./versions/nightly/pages/training/packed-sequences.mdx": 21
 "./versions/nightly/pages/training/multi-token-prediction.mdx": 22
 "./versions/nightly/pages/training/callbacks.mdx": 23
+"./versions/nightly/pages/models/nemotron/nemotron3-ultra.mdx": 7
+"./versions/nightly/pages/models/nemotron/nemotron3.5-super-vl.mdx": 9
+"./versions/nightly/pages/models/nemotron/nemotron3.5-super-vl-text-only.mdx": 10

docs/fern/versions/_nav_order.yml

@@ -130,20 +130,20 @@ navigation:
       path: ./nightly/pages/models/nemotron/nemotron3-nano.mdx
     - page: Nemotron 3 Nano 4B
       path: ./nightly/pages/models/nemotron/nemotron3-nano-4b.mdx
+    - page: Nemotron-3 Nano Omni
+      path: ./nightly/pages/models/nemotron/nemotron-3-omni.mdx
     - page: Nemotron 3 Super
       path: ./nightly/pages/models/nemotron/nemotron3-super.mdx
+    - page: Nemotron 3 Ultra
+      path: ./nightly/pages/models/nemotron/nemotron3-ultra.mdx
     - page: Nemotron 3.5 Lightning
       path: ./nightly/pages/models/nemotron/nemotron3.5-lightning.mdx
     - page: Nemotron 3.5 Super VL
       path: ./nightly/pages/models/nemotron/nemotron3.5-super-vl.mdx
     - page: Nemotron-3.5 Super Text-only
       path: ./nightly/pages/models/nemotron/nemotron3.5-super-vl-text-only.mdx
-    - page: Nemotron 3 Ultra
-      path: ./nightly/pages/models/nemotron/nemotron3-ultra.mdx
     - page: Nemotron Nano V2 VL
       path: ./nightly/pages/models/nemotron/nemotron-nano-v2-vl.mdx
-    - page: Nemotron-3 Nano Omni
-      path: ./nightly/pages/models/nemotron/nemotron-3-omni.mdx
     section: Nemotron
   - contents:
     - page: OLMoE

docs/fern/versions/nightly.yml

@@ -115,10 +115,6 @@ Choose a model to inspect its recorded import/export, training, and precision co
       <span>8 models</span>
     </header>
     <div class="verification-provider-models">
-      <a class="verification-model-link" href="nemotron/nemotron-3-omni#verified-nemotron-3-nano-omni-30b-a3b-reasoning">
-        <strong title="nvidia/Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16">Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16</strong>
-        <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
-      </a>
       <a class="verification-model-link" href="nemotron/nemotron3-nano#verified-nemotron-3-nano-30b-a3b">
         <strong title="nvidia/NVIDIA-Nemotron-3-Nano-30B-A3B-BF16">NVIDIA-Nemotron-3-Nano-30B-A3B-BF16</strong>
         <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
@@ -127,6 +123,10 @@ Choose a model to inspect its recorded import/export, training, and precision co
         <strong title="nvidia/NVIDIA-Nemotron-3-Nano-4B-BF16">NVIDIA-Nemotron-3-Nano-4B-BF16</strong>
         <span class="verification-status verification-status--verified" title="Verified">✓ Verified</span>
       </a>
+      <a class="verification-model-link" href="nemotron/nemotron-3-omni#verified-nemotron-3-nano-omni-30b-a3b-reasoning">
+        <strong title="nvidia/Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16">Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16</strong>
+        <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
+      </a>
       <a class="verification-model-link" href="nemotron/nemotron3-super#verified-nemotron-3-super-120b-a12b">
         <strong title="nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16">NVIDIA-Nemotron-3-Super-120B-A12B-BF16</strong> {/* pragma: allowlist secret */
         }

docs/fern/versions/nightly/pages/models/README.mdx

@@ -8,13 +8,13 @@ Nemotron model documentation is organized by model variant.
 | Nemotron H and Nemotron Nano v2 | [nemotronh.md](nemotronh.md) |
 | Nemotron-3 Nano 30B-A3B | [nemotron3-nano.md](nemotron3-nano.md) |
 | Nemotron-3 Nano 4B | [nemotron3-nano-4b.md](nemotron3-nano-4b.md) |
+| Nemotron-3 Nano Omni | [nemotron-3-omni.md](nemotron-3-omni.md) |
 | Nemotron-3 Super | [nemotron3-super.md](nemotron3-super.md) |
+| Nemotron-3 Ultra | [nemotron3-ultra.md](nemotron3-ultra.md) |
 | Nemotron-3.5 Lightning | [nemotron3.5-lightning.md](nemotron3.5-lightning.md) |
 | Nemotron-3.5 Super VL | [nemotron3.5-super-vl.md](nemotron3.5-super-vl.md) |
 | Nemotron-3.5 Super Text-only | [nemotron3.5-super-vl-text-only.md](nemotron3.5-super-vl-text-only.md) |
-| Nemotron-3 Ultra | [nemotron3-ultra.md](nemotron3-ultra.md) |
 | Nemotron Nano V2 VL | [nemotron-nano-v2-vl.md](nemotron-nano-v2-vl.md) |
-| Nemotron-3 Nano Omni | [nemotron-3-omni.md](nemotron-3-omni.md) |
 
 ## Examples
 

docs/fern/versions/nightly/pages/models/nemotron/index.mdx

@@ -115,10 +115,6 @@ Choose a model to inspect its recorded import/export, training, and precision co
       <span>8 models</span>
     </header>
     <div class="verification-provider-models">
-      <a class="verification-model-link" href="nemotron/nemotron-3-omni.html#verified-nemotron-3-nano-omni-30b-a3b-reasoning">
-        <strong title="nvidia/Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16">Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16</strong>
-        <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
-      </a>
       <a class="verification-model-link" href="nemotron/nemotron3-nano.html#verified-nemotron-3-nano-30b-a3b">
         <strong title="nvidia/NVIDIA-Nemotron-3-Nano-30B-A3B-BF16">NVIDIA-Nemotron-3-Nano-30B-A3B-BF16</strong>
         <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
@@ -127,6 +123,10 @@ Choose a model to inspect its recorded import/export, training, and precision co
         <strong title="nvidia/NVIDIA-Nemotron-3-Nano-4B-BF16">NVIDIA-Nemotron-3-Nano-4B-BF16</strong>
         <span class="verification-status verification-status--verified" title="Verified">✓ Verified</span>
       </a>
+      <a class="verification-model-link" href="nemotron/nemotron-3-omni.html#verified-nemotron-3-nano-omni-30b-a3b-reasoning">
+        <strong title="nvidia/Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16">Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16</strong>
+        <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
+      </a>
       <a class="verification-model-link" href="nemotron/nemotron3-super.html#verified-nemotron-3-super-120b-a12b">
         <strong title="nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16">NVIDIA-Nemotron-3-Super-120B-A12B-BF16</strong> <!-- pragma: allowlist secret -->
         <span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>

docs/models/README.md

@@ -9,13 +9,13 @@ llama-nemotron.md
 nemotronh.md
 nemotron3-nano.md
 nemotron3-nano-4b.md
+nemotron-3-omni.md
 nemotron3-super.md
+nemotron3-ultra.md
 nemotron3.5-lightning.md
 nemotron3.5-super-vl.md
 nemotron3.5-super-vl-text-only.md
-nemotron3-ultra.md
 nemotron-nano-v2-vl.md
-nemotron-3-omni.md
 ```
 
 | Variant | Guide |
@@ -24,13 +24,13 @@ nemotron-3-omni.md
 | Nemotron H and Nemotron Nano v2 (deprecated) | [nemotronh.md](nemotronh.md) |
 | Nemotron-3 Nano 30B-A3B | [nemotron3-nano.md](nemotron3-nano.md) |
 | Nemotron-3 Nano 4B | [nemotron3-nano-4b.md](nemotron3-nano-4b.md) |
+| Nemotron-3 Nano Omni | [nemotron-3-omni.md](nemotron-3-omni.md) |
 | Nemotron-3 Super | [nemotron3-super.md](nemotron3-super.md) |
+| Nemotron-3 Ultra | [nemotron3-ultra.md](nemotron3-ultra.md) |
 | Nemotron-3.5 Lightning | [nemotron3.5-lightning.md](nemotron3.5-lightning.md) |
 | Nemotron-3.5 Super VL | [nemotron3.5-super-vl.md](nemotron3.5-super-vl.md) |
 | Nemotron-3.5 Super Text-only | [nemotron3.5-super-vl-text-only.md](nemotron3.5-super-vl-text-only.md) |
-| Nemotron-3 Ultra | [nemotron3-ultra.md](nemotron3-ultra.md) |
 | Nemotron Nano V2 VL (deprecated) | [nemotron-nano-v2-vl.md](nemotron-nano-v2-vl.md) |
-| Nemotron-3 Nano Omni | [nemotron-3-omni.md](nemotron-3-omni.md) |
 
 ## Examples
 

docs/models/nemotron/index.md

@@ -5,11 +5,11 @@ This directory contains model-specific examples for the Nemotron family:
 | Model | Parameters | Active Parameters | Subdirectory |
 |-------|-----------|-------------------|--------------|
 | Nemotron 3 Nano | 30B | A3B | [nemotron_3_nano/](nemotron_3_nano/) |
-| Nemotron 3.5 Lightning | 30B | A3B | [nemotron_3_5_lightning/](nemotron_3_5_lightning/) |
-| Nemotron 3 Super | 120B | A12B | [nemotron_3_super/](nemotron_3_super/) |
 | Nemotron 3 Nano Omni | 30B | A3B | [nemotron_3_nano_omni/](nemotron_3_nano_omni/) |
-| Nemotron 3.5 Super VL | 120B language model | A12B | [nemotron_3_5_super_vl/](nemotron_3_5_super_vl/) (draft) |
+| Nemotron 3 Super | 120B | A12B | [nemotron_3_super/](nemotron_3_super/) |
 | Nemotron 3 Ultra | 550B | A55B | [nemotron_3_ultra/](nemotron_3_ultra/) |
+| Nemotron 3.5 Lightning | 30B | A3B | [nemotron_3_5_lightning/](nemotron_3_5_lightning/) |
+| Nemotron 3.5 Super VL | 120B language model | A12B | [nemotron_3_5_super_vl/](nemotron_3_5_super_vl/) (draft) |
 
 ## Path migration
 

examples/models/nemotron/README.md

@@ -443,7 +443,14 @@ def build_catalog(repo_root: Path) -> dict[str, object]:
     if not cards:
         raise CatalogError(f"no cards matched {CARD_GLOB}")
     models = [normalize_card(card, repo_root) for card in cards]
-    models.sort(key=lambda model: (str(model["hf_id"]).casefold(), str(model["slug"])))
+    # Ignore the repeated vendor prefix so Nano precedes Nano Omni, followed
+    # by Super, Ultra, Lightning, and Super VL in every generated model list.
+    models.sort(
+        key=lambda model: (
+            str(model["hf_id"]).casefold().replace("nvidia/nvidia-nemotron-", "nvidia/nemotron-"),
+            str(model["slug"]),
+        )
+    )
     return {
         "schema_version": CATALOG_SCHEMA_VERSION,
         "source": CARD_GLOB,