fixes

Signed-off-by: Lawrence Lane <llane@nvidia.com>

Author: lbliii

.github/workflows/build-docs.yml

@@ -44,10 +44,13 @@ jobs:
           uv pip install \
             "myst-parser>=4.0.1" \
             "nvidia-sphinx-theme>=0.0.8" \
-            "sphinx>=8.1.3" \
-            "sphinx-autobuild>=2024.10.3" \
+            "sphinx>=8.2.3" \
+            "sphinx-autobuild>=2025.8.25" \
             "sphinx-autodoc2>=0.5.0" \
-            "sphinx-copybutton>=0.5.2"
+            "sphinx-copybutton>=0.5.2" \
+            "sphinxcontrib-mermaid>=1.0.0" \
+            "sphinx-design>=0.6.1" \
+            "swagger-plugin-for-sphinx>=6.0.0"
 
       - name: Build documentation
         run: |

docs/get-started/automodel.md

@@ -32,7 +32,7 @@ Complete end-to-end tutorial for fine-tuning and generating videos using NeMo DF
 :::{button-ref} gs-index
 :color: secondary
 :outline:
-:ref-type: doc
+:ref-type: ref
 
 ← Back to Get Started
 :::
@@ -305,7 +305,7 @@ Expected: `iter_1000/`, `iter_2000/`, `latest/` directories with `model_weights.
 ### Troubleshooting
 
 :::{dropdown} Out of Memory Errors
-:icon: warning
+:icon: alert
 
 ```
 RuntimeError: CUDA out of memory
@@ -433,7 +433,7 @@ xdg-open butterfly_garden.mp4  # Linux
 ### Troubleshooting
 
 :::{dropdown} Out of Memory Errors
-:icon: warning
+:icon: alert
 
 ```
 RuntimeError: CUDA out of memory

docs/get-started/megatron.md

@@ -32,7 +32,7 @@ Complete end-to-end tutorial for pretraining a DiT model and generating videos u
 :::{button-ref} gs-index
 :color: secondary
 :outline:
-:ref-type: doc
+:ref-type: ref
 
 ← Back to Get Started
 :::
@@ -131,7 +131,7 @@ Each sample: `.pth` (image latents), `.pickle` (T5 embeddings), `.json` (metadat
 ### Troubleshooting
 
 :::{dropdown} Out of Memory During Preparation
-:icon: warning
+:icon: alert
 
 ```text
 RuntimeError: CUDA out of memory
@@ -293,7 +293,7 @@ Training continues from iteration 5000.
 ### Troubleshooting
 
 :::{dropdown} Out of Memory Errors
-:icon: warning
+:icon: alert
 
 ```text
 RuntimeError: CUDA out of memory
@@ -327,7 +327,7 @@ Generate videos from your trained DiT model checkpoint using Megatron inference.
 The inference script expects a consolidated `model.pth` file. Training saves checkpoints in `checkpoints/dit_butterfly/iter_5000/` with `model.pth` and `extra_state.pt` files.
 
 :::{dropdown} Consolidate Sharded Checkpoint (If Needed)
-:icon: warning
+:icon: alert
 
 If your checkpoint is distributed across multiple files, consolidate:
 
@@ -406,7 +406,7 @@ ls -lh idx=0_rank=0_butterfly_monarch.mp4
 ### Troubleshooting
 
 :::{dropdown} Model Loading Error
-:icon: warning
+:icon: alert
 
 ```text
 FileNotFoundError: model.pth not found
@@ -420,7 +420,7 @@ cp checkpoints/dit_butterfly/iter_5000/model.pth .
 :::
 
 :::{dropdown} Out of Memory Errors
-:icon: warning
+:icon: alert
 
 ```text
 RuntimeError: CUDA out of memory

docs/index.md

@@ -63,13 +63,13 @@ Set up your environment and install NeMo DFM.
 :::
 
 :::{grid-item-card} {octicon}`play;1.5em;sd-mr-1` Training Quickstart
-:link: gs-training
+:link: gs-index
 :link-type: ref
 Run your first video diffusion model training job.
 :::
 
 :::{grid-item-card} {octicon}`image;1.5em;sd-mr-1` Inference Quickstart
-:link: gs-inference
+:link: gs-index
 :link-type: ref
 Generate videos using trained models.
 :::