formatting (#33)

ROCm · Dec 20, 2023 · 9afe986 · 9afe986
1 parent 351c866
commit 9afe986
Show file tree

Hide file tree

Showing 2 changed files with 70 additions and 178 deletions.
diff --git a/docs/reference/system-requirements.rst b/docs/reference/system-requirements.rst
@@ -1,7 +1,11 @@
+.. meta::
+  :description: Linux GPU and OS support
+  :keywords: Linux support, ROCm distributions
+
 .. _system-requirements:
 
 **************************************************************************************
-System requirements
+System requirements (Linux)
 **************************************************************************************
 
 Supported GPUs
@@ -12,115 +16,50 @@ GPU is not listed on this table, It's not officially supported by AMD.
 
 .. tab-set::
 
-    .. tab-item:: AMD Instinct™
-
-        .. list-table::
-            :widths: 50 25 25 10
-            :header-rows: 1
-
-            * - GPU
-              - Architecture
-              - LLVM target
-              - Support
-
-            * - AMD Instinct™ MI300X
-              - CDNA3
-              - gfx942
-              - ✅
-            * - AMD Instinct™ MI300A
-              - CDNA3
-              - gfx942
-              - ✅ [#]_
-
-            * - AMD Instinct™ MI250X
-              - CDNA2
-              - gfx90a
-              - ✅
-            * - AMD Instinct™ MI250
-              - CDNA2
-              - gfx90a
-              - ✅
-            * - AMD Instinct™ MI210
-              - CDNA2
-              - gfx90a
-              - ✅
-
-            * - AMD Instinct™ MI100
-              - CDNA
-              - gfx908
-              - ✅
-
-            * - AMD Instinct™ MI50
-              - GCN5.1
-              - gfx906
-              - ⚠️
-            * - AMD Instinct™ MI25
-              - GCN5.0
-              - gfx900
-              - ❌
-
-    .. tab-item:: AMD Radeon Pro™
-
-        .. list-table::
-            :widths: 50 25 25 10
-            :header-rows: 1
-
-            * - GPU
-              - Architecture
-              - LLVM target
-              - Support
-
-            * - AMD Radeon™ Pro W7900
-              - RDNA3
-              - gfx1100
-              - ✅
-            * - AMD Radeon™ Pro W6800
-              - RDNA3
-              - gfx1030
-              - ✅
-            * - AMD Radeon™ Pro V620
-              - RDNA2
-              - gfx1030
-              - ✅
-            * - AMD Radeon™ Pro VII
-              - RDNA2
-              - GCN5.1
-              - ✅
-
-    .. tab-item:: AMD Radeon™
-
-        .. list-table::
-            :widths: 50 25 25 10
-            :header-rows: 1
-
-            * - GPU
-              - Architecture
-              - LLVM target
-              - Support
-
-            * - AMD Radeon™ RX 7900 XTX
-              - RDNA3
-              - gfx1100
-              - ✅
-            * - AMD Radeon™ RX 7900 XT
-              - RDNA3
-              - gfx1100
-              - ✅
-            * - AMD Radeon™ VII
-              - GCN5.1
-              - gfx906
-              - ✅
-
-Support status:
+  .. tab-item:: AMD Instinct™
+
+    .. csv-table::
+      :widths: 50, 25, 25, 10
+      :header: "GPU", "Architecture", "LLVM target", "Support"
+
+      "AMD Instinct™ MI300X", "CDNA3", "gfx942", "✅"
+      "AMD Instinct™ MI300A", "CDNA3", "gfx942", "✅ :sup:`1`"
+      "AMD Instinct™ MI250X", "CDNA2", "gfx90a", "✅"
+      "AMD Instinct™ MI250", "CDNA2", "gfx90a", "✅"
+      "AMD Instinct™ MI210", "CDNA2", "gfx90a", "✅"
+      "AMD Instinct™ MI100", "CDNA", "gfx908", "✅"
+      "AMD Instinct™ MI50", "GCN5.1", "gfx906", "⚠️"
+      "AMD Instinct™ MI25", "GCN5.0", "gfx900", "❌"
+
+  .. tab-item:: AMD Radeon Pro™
+
+    .. csv-table::
+      :widths: 50, 25, 25, 10
+      :header: "GPU", "Architecture", "LLVM target", "Support"
+
+      "AMD Radeon™ Pro W7900", "RDNA3", "gfx1100", "✅"
+      "AMD Radeon™ Pro W6800", "RDNA3", "gfx1030", "✅"
+      "AMD Radeon™ Pro V620", "RDNA2", "gfx1030", "✅"
+      "AMD Radeon™ Pro VII", "RDNA2", "GCN5.1", "✅"
+
+  .. tab-item:: AMD Radeon™
+
+    .. csv-table::
+      :widths: 50, 25, 25, 10
+      :header: "GPU", "Architecture", "LLVM target", "Support"
+
+      "AMD Radeon™ RX 7900 XTX", "RDNA3", "gfx1100", "✅"
+      "AMD Radeon™ RX 7900 XT", "RDNA3", "gfx1100", "✅"
+      "AMD Radeon™ VII", "GCN5.1", "gfx906", "✅"
 
 ✅: **Supported** - AMD enables these GPUs in our software distributions for the corresponding
-ROCm product.\
-⚠️: **Deprecated** - Support will be removed in a future release.\
-❌: **Unsupported** - This configuration is not enabled in our software distributions.\
+ROCm product.
 
-.. [#]
-    MI300A is currently not officially supported on RHEL 9.x.
-    This will be added on a later date.
+⚠️: **Deprecated** - Support will be removed in a future release.
+
+❌: **Unsupported** - This configuration is not enabled in our software distributions.
+
+:sup:`1` MI300A is currently not officially supported on RHEL 9.x. This will be added on a later date.
 
 .. _supported_distributions:
 
@@ -129,81 +68,34 @@ Supported operating systems
 
 AMD ROCm™ Software supports the following Linux distributions.
 
-.. list-table::
-    :widths: 50 50 25
-    :header-rows: 1
-
-    * - OS
-      - Kernel
-      - Support
-
-    * - RHEL 9.3
-      - 5.14.0-362
-      - ✅
-    * - RHEL 9.2
-      - 5.14.0-362
-      - ✅
-
-    * - RHEL 8.9
-      - 4.18-513
-      - ✅
-    * - RHEL 8.8
-      - 4.18-513
-      - ✅
-
-    * - CentOS 7.9
-      - 3.10
-      - ✅
-
-    * - SLES 15 SP5
-      - 5.14.21-150500
-      - ✅
-    * - SLES 15 SP4
-      - 5.14.21-150500
-      - ✅
-
-    * - Ubuntu 22.04.3
-      - 6.2
-      - ✅
-    * - Ubuntu 22.04.2
-      - 5.19
-      - ✅
-
-    * - Ubuntu 20.04.6
-      - 5.15
-      - ✅
-    * - Ubuntu 20.04.5
-      - 5.15
-      - ✅
+.. csv-table::
+    :widths: 50, 50, 25
+    :header: "OS", "Kernel", "Support"
+
+    "RHEL 9.3", 5.14.0-362", "✅"
+    "RHEL 9.2", "5.14.0-362", "✅"
+    "RHEL 8.9", "4.18-513", "✅"
+    "RHEL 8.8", "4.18-513", "✅"
+    "CentOS 7.9", "3.10", "✅"
+    "SLES 15 SP5", "5.14.21-150500", "✅"
+    "SLES 15 SP4", "5.14.21-150500", "✅"
+    "Ubuntu 22.04.3", "6.2", "✅"
+    "Ubuntu 22.04.2", "5.19", "✅"
+    "Ubuntu 20.04.6", "5.15", "✅"
+    "Ubuntu 20.04.5", "5.15", "✅"
 
 Virtualization support
 =============================================
 
 ROCm supports virtualization for select GPUs only as shown below.
 
-.. list-table::
-    :widths: 50 25 25 50
-    :header-rows: 1
-
-    * - Hypervisor
-      - Version
-      - GPU
-      - Validated Guest OS (Kernel)
-
-    * - VMWare
-      - ESXI 8
-      - MI250
-      - Ubuntu 20.04 (5.15.0)
-
-    * - VMWare
-      - ESXI 8
-      - MI210
-      - Ubuntu 20.04 (5.15.0), SLES 15 SP4 (5.14.21)
-
-    * - VMWare
-      - ESXI 7
-      - MI210
-      - Ubuntu 20.04 (5.15.0), SLES 15 SP4 (5.14.21)
+.. csv-table::
+    :widths: 50, 25, 25, 50
+    :header: "Hypervisor", "Version", "GPU", "Validated Guest OS (Kernel)"
+
+    "VMWare", "ESXI 8", "MI250", "Ubuntu 20.04 (5.15.0)"
+    "VMWare", "ESXI 8", "MI210", "Ubuntu 20.04 (5.15.0), SLES 15 SP4 (5.14.21)"
+    "VMWare", "ESXI 7", "MI210", "Ubuntu 20.04 (5.15.0), SLES 15 SP4 (5.14.21)"
 
 CPU support
 =============================================

diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in
@@ -10,6 +10,8 @@ subtrees:
       title: Quick-start install guide
     - file: how-to/prerequisites
       title: Prerequisites
+    - file: reference/system-requirements
+      title: System requirements
     - file: how-to/amdgpu-install
       title: Installation via AMDGPU installer
     - file: how-to/native-install/index
@@ -45,8 +47,6 @@ subtrees:
 
 - caption: Reference
   entries:
-    - file: reference/system-requirements
-      title: System requirements
     - file: reference/3rd-party-support-matrix
       title: Third-party support
     - file: reference/docker-image-support-matrix