Apply suggestion from @randyh62

OK

docs/how-to/deep-learning-rocm.rst

@@ -24,7 +24,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
       - GitHub
 
     * - :doc:`PyTorch <../compatibility/ml-compatibility/pytorch-compatibility>`
-      - :doc:`Pytorch install <rocm-install-on-linux:install/3rd-party/pytorch-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/pytorch-install>`
       - 
         - Docker image
         - Wheels package
@@ -35,7 +35,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/pytorch"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`TensorFlow <../compatibility/ml-compatibility/tensorflow-compatibility>`
-      - :doc:`TensorFlow install <rocm-install-on-linux:install/3rd-party/tensorflow-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/tensorflow-install>`
       - 
         - Docker image
         - Wheels package
@@ -45,7 +45,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/tensorflow-upstream"><i class="fab fa-github fa-lg"></i></a> 
 
     * - :doc:`JAX <../compatibility/ml-compatibility/jax-compatibility>`
-      - :doc:`JAX install <rocm-install-on-linux:install/3rd-party/jax-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/jax-install>`
       - 
         - Docker image
       - .. raw:: html
@@ -53,7 +53,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/jax"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`verl <../compatibility/ml-compatibility/verl-compatibility>`
-      - :doc:`verl install <rocm-install-on-linux:install/3rd-party/verl-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/verl-install>`
       - 
         - Docker image
       - .. raw:: html
@@ -61,7 +61,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/verl"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`Stanford Megatron-LM <../compatibility/ml-compatibility/stanford-megatron-lm-compatibility>`
-      - :doc:`Stanford Megatron-LM install <rocm-install-on-linux:install/3rd-party/stanford-megatron-lm-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/stanford-megatron-lm-install>`
       - 
         - Docker image
       - .. raw:: html
@@ -69,7 +69,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/Stanford-Megatron-LM"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`DGL <../compatibility/ml-compatibility/dgl-compatibility>`
-      - :doc:`DGL install <rocm-install-on-linux:install/3rd-party/dgl-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/dgl-install>`
       - 
         - Docker image
       - .. raw:: html
@@ -77,24 +77,15 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/dgl"><i class="fab fa-github fa-lg"></i></a> 
 
     * - :doc:`Megablocks <../compatibility/ml-compatibility/megablocks-compatibility>`
-      - :doc:`Megablocks install <rocm-install-on-linux:install/3rd-party/megablocks-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/megablocks-install>`
       - 
         - Docker image
       - .. raw:: html
 
           <a href="https://github.com/ROCm/megablocks"><i class="fab fa-github fa-lg"></i></a>
 
-    * - :doc:`Taichi <../compatibility/ml-compatibility/taichi-compatibility>`
-      - `Taichi install <https://rocm.docs.amd.com/projects/taichi/en/latest/install/taichi-install.html>`__
-      - 
-        - Docker image
-        - Wheels package
-      - .. raw:: html
-
-          <a href="https://github.com/ROCm/taichi"><i class="fab fa-github fa-lg"></i></a>
-
     * - :doc:`Ray <../compatibility/ml-compatibility/ray-compatibility>`
-      - :doc:`Ray install <rocm-install-on-linux:install/3rd-party/ray-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/ray-install>`
       - 
         - Docker image
         - Wheels package
@@ -104,7 +95,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/ray"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`llama.cpp <../compatibility/ml-compatibility/llama-cpp-compatibility>`
-      - :doc:`llama.cpp install <rocm-install-on-linux:install/3rd-party/llama-cpp-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/llama-cpp-install>`
       - 
         - Docker image
         - ROCm Base Docker image
@@ -113,7 +104,7 @@ The table below summarizes information about ROCm-enabled deep learning framewor
           <a href="https://github.com/ROCm/llama.cpp"><i class="fab fa-github fa-lg"></i></a>
 
     * - :doc:`FlashInfer <../compatibility/ml-compatibility/flashinfer-compatibility>`
-      - :doc:`FlashInfer install <rocm-install-on-linux:install/3rd-party/flashinfer-install>`
+      - :doc:`link <rocm-install-on-linux:install/3rd-party/flashinfer-install>`
       - 
         - Docker image
         - ROCm Base Docker image

docs/sphinx/_toc.yml.in

@@ -29,27 +29,25 @@ subtrees:
     title: Deep learning frameworks
     subtrees:
     - entries:
-      - file: compatibility/ml-compatibility/pytorch-compatibility
+      - file: compatibility/ml-compatibility/pytorch-compatibility.rst
         title: PyTorch compatibility
-      - file: compatibility/ml-compatibility/tensorflow-compatibility
+      - file: compatibility/ml-compatibility/tensorflow-compatibility.rst
         title: TensorFlow compatibility
-      - file: compatibility/ml-compatibility/jax-compatibility
+      - file: compatibility/ml-compatibility/jax-compatibility.rst
         title: JAX compatibility
-      - file: compatibility/ml-compatibility/verl-compatibility
+      - file: compatibility/ml-compatibility/verl-compatibility.rst
         title: verl compatibility
-      - file: compatibility/ml-compatibility/stanford-megatron-lm-compatibility
+      - file: compatibility/ml-compatibility/stanford-megatron-lm-compatibility.rst
         title: Stanford Megatron-LM compatibility
-      - file: compatibility/ml-compatibility/dgl-compatibility
+      - file: compatibility/ml-compatibility/dgl-compatibility.rst
         title: DGL compatibility
-      - file: compatibility/ml-compatibility/megablocks-compatibility
+      - file: compatibility/ml-compatibility/megablocks-compatibility.rst
         title: Megablocks compatibility
-      - file: compatibility/ml-compatibility/taichi-compatibility
-        title: Taichi compatibility
-      - file: compatibility/ml-compatibility/ray-compatibility
+      - file: compatibility/ml-compatibility/ray-compatibility.rst
         title: Ray compatibility
-      - file: compatibility/ml-compatibility/llama-cpp-compatibility
+      - file: compatibility/ml-compatibility/llama-cpp-compatibility.rst
         title: llama.cpp compatibility
-      - file: compatibility/ml-compatibility/flashinfer-compatibility
+      - file: compatibility/ml-compatibility/flashinfer-compatibility.rst
         title: FlashInfer compatibility
   - file: how-to/build-rocm.rst
     title: Build ROCm from source
@@ -77,8 +75,14 @@ subtrees:
         - entries:
           - file: how-to/rocm-for-ai/training/benchmark-docker/primus-megatron.rst
             title: Train a model with Primus and Megatron-LM
+            entries:
+            - file: how-to/rocm-for-ai/training/benchmark-docker/megatron-lm.rst
+              title: Train a model with Megatron-LM
           - file: how-to/rocm-for-ai/training/benchmark-docker/primus-pytorch.rst
             title: Train a model with Primus and PyTorch
+            entries:
+            - file: how-to/rocm-for-ai/training/benchmark-docker/pytorch-training.rst
+              title: Train a model with PyTorch
           - file: how-to/rocm-for-ai/training/benchmark-docker/jax-maxtext.rst
             title: Train a model with JAX MaxText
           - file: how-to/rocm-for-ai/training/benchmark-docker/mpt-llm-foundry
@@ -117,6 +121,8 @@ subtrees:
             title: SGLang inference performance testing
           - file: how-to/rocm-for-ai/inference/benchmark-docker/sglang-distributed.rst
             title: SGLang distributed inference with Mooncake
+          - file: how-to/rocm-for-ai/inference/xdit-diffusion-inference.rst
+            title: xDiT diffusion inference
           - file: how-to/rocm-for-ai/inference/deploy-your-model.rst
             title: Deploy your model
 
@@ -134,6 +140,8 @@ subtrees:
             title: Profile and debug
           - file: how-to/rocm-for-ai/inference-optimization/workload.rst
             title: Workload optimization
+          - file: how-to/rocm-for-ai/inference-optimization/vllm-optimization.rst
+            title: vLLM V1 performance optimization
 
       - url: https://rocm.docs.amd.com/projects/ai-developer-hub/en/latest/
         title: AI tutorials
@@ -180,7 +188,7 @@ subtrees:
           - file: conceptual/gpu-arch/mi300-mi200-performance-counters.rst
             title: MI300 and MI200 performance counters
           - file: conceptual/gpu-arch/mi350-performance-counters.rst
-            title: MI350 series performance counters
+            title: MI350 Series performance counters
       - file: conceptual/gpu-arch/mi250.md
         title: MI250 microarchitecture
         subtrees:
@@ -214,6 +222,8 @@ subtrees:
     title: ROCm tools, compilers, and runtimes
   - file: reference/gpu-arch-specs.rst
   - file: reference/gpu-atomics-operation.rst
+  - file: reference/env-variables.rst
+    title: Environment variables
   - file: reference/precision-support.rst
     title: Data types and precision support
   - file: reference/graph-safe-support.rst