Skip to content

Commit f54dbc1

Browse files
fix(docs): render verification catalog as valid Fern MDX
Signed-off-by: svcnemo-autobot <svcnemo-autobot@nvidia.com>
1 parent 7038de4 commit f54dbc1

36 files changed

Lines changed: 482 additions & 688 deletions

‎.github/workflows/fern-docs-ci.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ on:
2727
permissions:
2828
contents: read
2929

30+
env:
31+
FERN_NO_VERSION_REDIRECTION: "true"
32+
3033
jobs:
3134
check:
3235
runs-on: ubuntu-latest

‎.github/workflows/fern-docs-preview.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ concurrency:
2727
group: ${{ github.workflow }}-${{ github.ref }}
2828
cancel-in-progress: true
2929

30+
env:
31+
FERN_NO_VERSION_REDIRECTION: "true"
32+
3033
jobs:
3134
changed-files:
3235
runs-on: ubuntu-latest

‎.github/workflows/publish-fern-docs.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,9 @@ concurrency:
3636
group: fern-publish
3737
cancel-in-progress: true
3838

39+
env:
40+
FERN_NO_VERSION_REDIRECTION: "true"
41+
3942
jobs:
4043
publish:
4144
runs-on: ubuntu-latest

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- Generated by scripts/docs/generate_model_verification_catalog.py. Do not edit. -->
1+
{/* Generated by scripts/docs/generate_model_verification_catalog.py. Do not edit. */}
22

33
# Supported Models
44

@@ -128,11 +128,11 @@ Choose a model to inspect its recorded import/export, training, and precision co
128128
<span class="verification-status verification-status--verified" title="Verified">✓ Verified</span>
129129
</a>
130130
<a class="verification-model-link" href="nemotron/nemotron3-super#verified-nemotron-3-super-120b-a12b">
131-
<strong title="nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16">NVIDIA-Nemotron-3-Super-120B-A12B-BF16</strong> <!-- pragma: allowlist secret -->
131+
<strong title="nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16">NVIDIA-Nemotron-3-Super-120B-A12B-BF16</strong> {/* pragma: allowlist secret */}
132132
<span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
133133
</a>
134134
<a class="verification-model-link" href="nemotron/nemotron3-ultra#verified-nemotron-3-ultra-550b-a55b">
135-
<strong title="nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16">NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16</strong> <!-- pragma: allowlist secret -->
135+
<strong title="nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16">NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16</strong> {/* pragma: allowlist secret */}
136136
<span class="verification-status verification-status--partial" title="Partial">◐ Partial</span>
137137
</a>
138138
<a class="verification-model-link" href="nemotron/nemotron3.5-lightning#verified-nemotron-3.5-lightning">

‎docs/fern/versions/nightly/pages/models/bagel/bagel.mdx‎

Lines changed: 11 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ for dependency setup, checkpoint initialization, training, and direct inference.
1212
See the [BAGEL data tutorial](https://github.com/NVIDIA-NeMo/Megatron-Bridge/blob/main/tutorials/data/bagel/README.md)
1313
for dataset preparation.
1414

15-
<!-- BEGIN GENERATED VERIFIED CONFIGURATIONS -->
15+
{/* BEGIN GENERATED VERIFIED CONFIGURATIONS */}
1616

1717
## Verified configurations
1818

@@ -131,8 +131,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
131131
</section>
132132
<section class="verification-expected-result">
133133
<h5>Expected result</h5>
134-
<p>BAGEL native-checkpoint initialization currently runs as part of GPU model construction and is not registered with the maintained public CPU conversion launcher.
135-
</p>
134+
<p>BAGEL native-checkpoint initialization currently runs as part of GPU model construction and is not registered with the maintained public CPU conversion launcher.</p>
136135
</section>
137136
</article>
138137
<article id="bagel-hf-to-megatron-gpu" class="verification-model-detail" data-entry-detail="bagel-hf-to-megatron-gpu" tabindex="-1">
@@ -157,8 +156,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
157156
</section>
158157
<section class="verification-expected-result">
159158
<h5>Expected result</h5>
160-
<p>The public GPU importer consumed the pinned official EMA state, reported 1,223 source tensors consumed and 943 target tensors verified, and wrote a standalone torch_dist checkpoint. A clean one-GPU reload completed without missing or unexpected checkpoint keys; all 56 MoT language-layer input-norm tensors used as regression sentinels exactly matched the official EMA values.
161-
</p>
159+
<p>The public GPU importer consumed the pinned official EMA state, reported 1,223 source tensors consumed and 943 target tensors verified, and wrote a standalone torch_dist checkpoint. A clean one-GPU reload completed without missing or unexpected checkpoint keys; all 56 MoT language-layer input-norm tensors used as regression sentinels exactly matched the official EMA values.</p>
162160
</section>
163161
</article>
164162
<article id="bagel-megatron-to-hf-cpu" class="verification-model-detail" data-entry-detail="bagel-megatron-to-hf-cpu" tabindex="-1">
@@ -177,8 +175,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
177175
</section>
178176
<section class="verification-expected-result">
179177
<h5>Expected result</h5>
180-
<p>Exporting a BAGEL Megatron checkpoint to a complete reloadable Hugging Face checkpoint is not implemented by the public CPU converter.
181-
</p>
178+
<p>Exporting a BAGEL Megatron checkpoint to a complete reloadable Hugging Face checkpoint is not implemented by the public CPU converter.</p>
182179
</section>
183180
</article>
184181
<article id="bagel-megatron-to-hf-gpu" class="verification-model-detail" data-entry-detail="bagel-megatron-to-hf-gpu" tabindex="-1">
@@ -197,8 +194,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
197194
</section>
198195
<section class="verification-expected-result">
199196
<h5>Expected result</h5>
200-
<p>Exporting a BAGEL Megatron checkpoint to a complete reloadable Hugging Face checkpoint is not implemented by the public GPU converter.
201-
</p>
197+
<p>Exporting a BAGEL Megatron checkpoint to a complete reloadable Hugging Face checkpoint is not implemented by the public GPU converter.</p>
202198
</section>
203199
</article>
204200
<article id="bagel-pretrain-h100" class="verification-model-detail" data-entry-detail="bagel-pretrain-h100" tabindex="-1">
@@ -256,8 +252,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
256252
</section>
257253
<section class="verification-expected-result">
258254
<h5>Expected result</h5>
259-
<p>The clean public-data run completes 10 BF16 optimizer steps on 8 H100s at TP1/PP1/CP1/DP8 and GBS/MBS 8/1. Every step has finite CE, MSE, and total loss with no skipped or NaN iterations. The final step reports CE 0.9156674, MSE 0.3265290, and total loss 1.242196. The final-10 averages include first-step compilation and are 16,383.960 ms and 195.540 model TFLOP/s/GPU; 2,250.005 token slots/GPU/s uses the fixed 36,864 maximum packed sequence slots rather than variable logical tokens. The post-setup configuration and iteration-10 model, optimizer, RNG, and per-DP dataloader state are persisted. A separate same-topology public-launcher load restored step 10 and exited without executing an additional optimizer step.
260-
</p>
255+
<p>The clean public-data run completes 10 BF16 optimizer steps on 8 H100s at TP1/PP1/CP1/DP8 and GBS/MBS 8/1. Every step has finite CE, MSE, and total loss with no skipped or NaN iterations. The final step reports CE 0.9156674, MSE 0.3265290, and total loss 1.242196. The final-10 averages include first-step compilation and are 16,383.960 ms and 195.540 model TFLOP/s/GPU; 2,250.005 token slots/GPU/s uses the fixed 36,864 maximum packed sequence slots rather than variable logical tokens. The post-setup configuration and iteration-10 model, optimizer, RNG, and per-DP dataloader state are persisted. A separate same-topology public-launcher load restored step 10 and exited without executing an additional optimizer step.</p>
261256
</section>
262257
</article>
263258
<article id="bagel-sft-h100" class="verification-model-detail" data-entry-detail="bagel-sft-h100" tabindex="-1">
@@ -301,8 +296,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
301296
</section>
302297
<section class="verification-expected-result">
303298
<h5>Expected result</h5>
304-
<p>The BAGEL fine-tuning recipe must complete a bounded pinned-data run with finite losses, all required metrics, and a reloadable checkpoint.
305-
</p>
299+
<p>The BAGEL fine-tuning recipe must complete a bounded pinned-data run with finite losses, all required metrics, and a reloadable checkpoint.</p>
306300
</section>
307301
</article>
308302
<article id="bagel-sft-long-context-h100" class="verification-model-detail" data-entry-detail="bagel-sft-long-context-h100" tabindex="-1">
@@ -346,8 +340,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
346340
</section>
347341
<section class="verification-expected-result">
348342
<h5>Expected result</h5>
349-
<p>The current BAGEL integration does not expose a maintained packed long-context fine-tuning recipe with context parallelism.
350-
</p>
343+
<p>The current BAGEL integration does not expose a maintained packed long-context fine-tuning recipe with context parallelism.</p>
351344
</section>
352345
</article>
353346
<article id="bagel-peft-h100" class="verification-model-detail" data-entry-detail="bagel-peft-h100" tabindex="-1">
@@ -391,8 +384,7 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
391384
</section>
392385
<section class="verification-expected-result">
393386
<h5>Expected result</h5>
394-
<p>BAGEL LoRA and other parameter-efficient fine-tuning workflows are not implemented by the current integration.
395-
</p>
387+
<p>BAGEL LoRA and other parameter-efficient fine-tuning workflows are not implemented by the current integration.</p>
396388
</section>
397389
</article>
398390
<article id="bagel-pretrain-fsdp-h100" class="verification-model-detail" data-entry-detail="bagel-pretrain-fsdp-h100" tabindex="-1">
@@ -450,11 +442,10 @@ Choose a workflow, precision, and exact recorded combination. The command and ex
450442
</section>
451443
<section class="verification-expected-result">
452444
<h5>Expected result</h5>
453-
<p>The 32-GPU TP1/PP1/CP1/DP32 real-data run completes exactly 30 BF16 steps at GBS/MBS 32/1 with one microbatch, block-23 language-model recompute, full vision recompute, Megatron FSDP, finite CE/MSE/total losses, and no skipped or NaN iterations. Steps 21-30 average 7,697.160 ms, 234.268 model TFLOP/s/GPU, 23.687% MFU, and 4,789.299 token slots/GPU/s using 36,864 maximum packed sequence slots and GBS 32 across 32 GPUs. The separately measured logical throughput is 4,428.810 tokens/GPU/s from 1,090,856.3 logical tokens per step. Logical tokens include text, ViT, VAE-latent, and special tokens and exclude physical padding. The variable packed sequence length averages 34,070.15 tokens/GPU over steps 6-30. Peak allocated/reserved memory is 58.594/62.919 GiB. The same steps 6-30 workload reports standalone raw metrics of 10,167.941 ms, 176.936 model TFLOP/s/GPU, and 17.890% MFU under official BAGEL. Do not compute a relative speedup: that run uses full language-model recompute and performs an EMA update, while the Bridge run uses block-23 recompute without EMA.
454-
</p>
445+
<p>The 32-GPU TP1/PP1/CP1/DP32 real-data run completes exactly 30 BF16 steps at GBS/MBS 32/1 with one microbatch, block-23 language-model recompute, full vision recompute, Megatron FSDP, finite CE/MSE/total losses, and no skipped or NaN iterations. Steps 21-30 average 7,697.160 ms, 234.268 model TFLOP/s/GPU, 23.687% MFU, and 4,789.299 token slots/GPU/s using 36,864 maximum packed sequence slots and GBS 32 across 32 GPUs. The separately measured logical throughput is 4,428.810 tokens/GPU/s from 1,090,856.3 logical tokens per step. Logical tokens include text, ViT, VAE-latent, and special tokens and exclude physical padding. The variable packed sequence length averages 34,070.15 tokens/GPU over steps 6-30. Peak allocated/reserved memory is 58.594/62.919 GiB. The same steps 6-30 workload reports standalone raw metrics of 10,167.941 ms, 176.936 model TFLOP/s/GPU, and 17.890% MFU under official BAGEL. Do not compute a relative speedup: that run uses full language-model recompute and performs an EMA update, while the Bridge run uses block-23 recompute without EMA.</p>
455446
</section>
456447
</article>
457448
</div>
458449
</div>
459450

460-
<!-- END GENERATED VERIFIED CONFIGURATIONS -->
451+
{/* END GENERATED VERIFIED CONFIGURATIONS */}

0 commit comments

Comments
 (0)