From 177da52de1d8f5e0f76f3482f4eac426a4b573ab Mon Sep 17 00:00:00 2001
From: Jiajun Li <jiajun.li@radixark.ai>
Date: Thu, 17 Sep 2026 22:48:14 -0700
Subject: [PATCH] docs: add Hardware Platforms navigation for NVIDIA and AMD
 (#3313)

---
 README.md                                     |  2 +-
 docs/README.md                                |  2 +-
 docs/docs.json                                | 26 +++++++------------
 docs/getting-started/installation.md          |  2 +-
 .../amd.md => hardware-platforms/amd-gpus.md} |  0
 docs/hardware-platforms/nvidia-gpus.md        |  6 +++++
 docs/hardware-platforms/overview.md           |  8 ++++++
 7 files changed, 26 insertions(+), 20 deletions(-)
 rename docs/{getting-started/amd.md => hardware-platforms/amd-gpus.md} (100%)
 create mode 100644 docs/hardware-platforms/nvidia-gpus.md
 create mode 100644 docs/hardware-platforms/overview.md

diff --git a/README.md b/README.md
index d178975f17..9546e6b353 100644
--- a/README.md
+++ b/README.md
@@ -83,7 +83,7 @@ the largest models all live on Megatron-LM. See
 - **Extensive hardware support.** NVIDIA GB300, GB200, B300, B200, H200, H100, and A100, and
   AMD MI355X, MI350X, MI325X, and MI300X. See
   [Installation](https://miles.radixark.com/docs/getting-started/installation#hardware-requirements)
-  for per-GPU status and [AMD ROCm](https://miles.radixark.com/docs/getting-started/amd) for
+  for per-GPU status and [AMD ROCm](https://miles.radixark.com/docs/hardware-platforms/amd-gpus) for
   the ROCm images.
 - **Wide recipe support.** GRPO, GSPO, PPO, and REINFORCE++ for RL, plus SFT and
   [on-policy distillation](https://miles.radixark.com/docs/advanced/on-policy-distillation).
diff --git a/docs/README.md b/docs/README.md
index 8ae0b6abf5..a26fe5760a 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -8,7 +8,7 @@ Live site: https://miles.radixark.com/docs
 docs/
 ├── docs.json        # Mintlify config: navigation, theme, redirects
 ├── index.md         # Homepage
-├── getting-started/ models/ user-guide/ advanced/
+├── getting-started/ hardware-platforms/ models/ user-guide/ advanced/
 ├── examples/ blog/
 ├── developer/
 │   └── ci/
diff --git a/docs/docs.json b/docs/docs.json
index 15bb7250a9..7f57d0d115 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -46,8 +46,7 @@
        "index",
        "getting-started/index",
        "getting-started/installation",
-       "getting-started/quick-start",
-       "getting-started/amd"
+       "getting-started/quick-start"
       ]
      },
      {
@@ -356,6 +355,14 @@
      "blog/index",
      "subscribe"
     ]
+   },
+   {
+    "tab": "Hardware",
+    "pages": [
+     "hardware-platforms/overview",
+     "hardware-platforms/nvidia-gpus",
+     "hardware-platforms/amd-gpus"
+    ]
    }
   ]
  },
@@ -380,21 +387,6 @@
    "source": "/developer/experimental-features",
    "destination": "/user-guide/training-backend#fsdp"
   },
-  {
-   "source": "/platforms/index",
-   "destination": "/getting-started/installation",
-   "permanent": true
-  },
-  {
-   "source": "/platforms/nvidia",
-   "destination": "/getting-started/installation",
-   "permanent": true
-  },
-  {
-   "source": "/platforms/amd",
-   "destination": "/getting-started/amd",
-   "permanent": true
-  },
   {
    "source": "/advanced/fp8-low-precision",
    "destination": "/advanced/low-precision",
diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 61f0cba3d2..d239fd5590 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -36,7 +36,7 @@ versions of SGLang, Megatron-LM, and a few CUDA kernels.
       -it rocm/sgl-dev:miles-rocm10-mi35x /bin/bash
     ```
 
-    See [AMD ROCm](/getting-started/amd) for more details.
+    See [AMD ROCm](/hardware-platforms/amd-gpus) for more details.
 
   </Tab>
 
diff --git a/docs/getting-started/amd.md b/docs/hardware-platforms/amd-gpus.md
similarity index 100%
rename from docs/getting-started/amd.md
rename to docs/hardware-platforms/amd-gpus.md
diff --git a/docs/hardware-platforms/nvidia-gpus.md b/docs/hardware-platforms/nvidia-gpus.md
new file mode 100644
index 0000000000..c6f045b281
--- /dev/null
+++ b/docs/hardware-platforms/nvidia-gpus.md
@@ -0,0 +1,6 @@
+---
+title: NVIDIA GPUs
+description: Get started with Miles on NVIDIA GPUs using the installation guide.
+---
+
+See the [Installation Guide](/getting-started/installation) to get started with Miles on NVIDIA GPUs.
diff --git a/docs/hardware-platforms/overview.md b/docs/hardware-platforms/overview.md
new file mode 100644
index 0000000000..9dfbdc654b
--- /dev/null
+++ b/docs/hardware-platforms/overview.md
@@ -0,0 +1,8 @@
+---
+title: Hardware Platforms
+sidebarTitle: Overview
+description: Platform-specific guides for running Miles on NVIDIA and AMD GPUs.
+---
+
+- [NVIDIA GPUs](/hardware-platforms/nvidia-gpus)
+- [AMD GPUs](/hardware-platforms/amd-gpus)