[docs/7.10] post-install - improve exports (#5783 )

[docs/7.10.0] Radeon cards: suggest amdgpu over RSL driver (#5770 )
[docs/7.10.0] selector: responsive css for narrow viewports (#5769 )
2026-01-10 15:18:11 -05:00 · 2025-12-16 16:25:41 -05:00 · 2025-12-12 17:19:04 -05:00 · 2025-12-12 15:20:09 -05:00 · 2025-12-12 00:21:09 -05:00 · 2025-12-12 00:06:32 -05:00
88 changed files with 4995 additions and 3643 deletions
--- a/.wordlist.txt
+++ b/.wordlist.txt
@@ -3,11 +3,8 @@ ABI
 ACE
 ACEs
 ACS
-AccVGPR
-AccVGPRs
 AITER
 ALU
-AllReduce
 AMD
 AMDGPU
 AMDGPUs
@@ -22,27 +19,32 @@ APIC
 APIs
 APU
 APUs
+ASAN
 ASIC
 ASICs
 ASan
-ASAN
 ASm
 ATI
-atomicRMW
+AccVGPR
+AccVGPRs
 AddressSanitizer
 AlexNet
+AllReduce
 Andrej
 Arb
 Autocast
 BARs
-BatchNorm
+BKC
 BLAS
 BMC
 BabelStream
+BatchNorm
+Bitwise
 Blit
 Blockwise
 Bluefield
 Bootloader
+BrainFloat
 Broadcom
 CAS
 CCD
@@ -61,7 +63,6 @@ CPF
 CPP
 CPU
 CPUs
-Cron
 CSC
 CSDATA
 CSE
@@ -72,48 +73,46 @@ CTests
 CU
 CUDA
 CUs
-CXX
 CX
+CXX
 Cavium
 CentOS
 ChatGPT
 CoRR
 Codespaces
+ComfyUI
 Commitizen
 CommonMark
 Concretized
 Conda
 ConnectX
 CountOnes
+Cron
 CuPy
-da
-Dashboarding
-Dataloading
 DBRX
 DDR
 DF
 DGEMM
 DGL
 DGLGraph
-dGPU
-dGPUs
 DIMM
 DKMS
 DL
 DMA
-DOMContentLoaded
 DNN
 DNNL
+DOMContentLoaded
 DPM
 DRI
 DW
 DWORD
+Dashboarding
 Dask
 DataFrame
 DataLoader
 DataParallel
+Dataloading
 Debian
-decompositions
 DeepSeek
 DeepSpeed
 Dependabot
@@ -121,24 +120,20 @@ Deprecations
 DevCap
 DirectX
 Disaggregated
-disaggregated
 Dockerfile
 Dockerized
 Doxygen
-dropless
 ELMo
 ENDPGM
 EPYC
 ESXi
 EoS
-etcd
-fas
 FBGEMM
-FIFOs
 FFT
 FFTs
 FFmpeg
 FHS
+FIFOs
 FIXME
 FMA
 FP
@@ -147,8 +142,8 @@ Filesystem
 FindDb
 Flang
 FlashAttention
-FlashInfer’s
 FlashInfer
+FlashInfer’s
 FluxBenchmark
 Fortran
 Fuyu
@@ -165,40 +160,39 @@ GDS
 GEMM
 GEMMs
 GFLOPS
-GFortran
 GFXIP
+GFortran
 GGUF
-Gemma
-GiB
 GIM
 GL
-Glibc
 GLXT
-Gloo
 GMI
 GPG
+GPGPU
 GPR
 GPT
 GPU
 GPU's
 GPUs
-Graphbolt
-GraphSage
 GRBM
 GRE
+Gemma
 GenAI
 GenZ
+GiB
 GitHub
 Gitpod
+Glibc
+Gloo
+GraphSage
+Graphbolt
 HBM
 HCA
 HGX
 HIPCC
-hipDataType
 HIPExtension
 HIPIFY
 HIPification
-hipification
 HIPify
 HPC
 HPCG
@@ -208,11 +202,12 @@ HSA
 HW
 HWE
 HWS
+HX
 Haswell
 Higgs
-href
-Hyperparameters
 Huggingface
+HunyuanVideo
+Hyperparameters
 IB
 ICD
 ICT
@@ -221,13 +216,10 @@ IDE
 IDEs
 IFWI
 IMDb
-IncDec
-instrSize
-interpolators
 IOMMU
 IOP
-IOPS
 IOPM
+IOPS
 IOV
 IRQ
 ISA
@@ -235,6 +227,7 @@ ISV
 ISVs
 ITL
 ImageNet
+IncDec
 InfiniBand
 Inlines
 IntelliSense
@@ -243,8 +236,8 @@ Intersphinx
 Intra
 Ioffe
 JAX's
-Jinja
 JSON
+Jinja
 Jupyter
 KFD
 KFDTest
@@ -252,10 +245,10 @@ KMD
 KV
 KVM
 Karpathy's
-KiB
-Kineto
 Keras
 Khronos
+KiB
+Kineto
 LAPACK
 LCLK
 LDS
@@ -265,21 +258,20 @@ LLVM
 LM
 LRU
 LSAN
+LSTMs
 LSan
 LTS
-LSTMs
-LteAll
 LanguageCrossEntropy
 LoRA
+LteAll
 MECO
 MEM
 MERCHANTABILITY
 MFMA
-MiB
 MIGraphX
 MIOpen
-MIOpenGEMM
 MIOpen's
+MIOpenGEMM
 MIVisionX
 MLM
 MMA
@@ -290,11 +282,12 @@ MNIST
 MPI
 MPT
 MSVC
-mul
 MVAPICH
 MVFFR
+MXFP
 Makefile
 Makefiles
+ManyLinux
 Matplotlib
 Matrox
 MaxText
@@ -304,16 +297,16 @@ Megatron
 Mellanox
 Mellanox's
 Meta's
+MiB
 Miniconda
 MirroredStrategy
 Mixtral
-MosaicML
 MoEs
 Mooncake
+MosaicML
 Mpops
 Multicore
 Multithreaded
-MXFP
 MyEnvironment
 MyST
 NANOO
@@ -321,24 +314,27 @@ NBIO
 NBIOs
 NCCL
 NCF
+NCS
 NFS
 NIC
 NICs
 NLI
 NLP
 NN
+NOP
 NPKit
 NPS
 NSP
 NUMA
 NVCC
 NVIDIA
+NVLink
 NVPTX
 NaN
 Nano
 Navi
-Noncoherently
 NoReturn
+Noncoherently
 NousResearch's
 NumPy
 OAM
@@ -365,21 +361,21 @@ OpenVX
 OpenXLA
 Optim
 Oversubscription
-PagedAttention
-Pallas
 PCC
 PCI
 PCIe
 PEFT
-perf
 PEQT
 PIL
 PILImage
+PLDM
 POR
 PRNG
 PRs
 PaLM
 Pageable
+PagedAttention
+Pallas
 PeerDirect
 PerfDb
 Perfetto
@@ -392,8 +388,8 @@ Pretraining
 Primus
 Profiler's
 PyPi
-Pytest
 PyTorch
+Pytest
 Qcycles
 Qwen
 RAII
@@ -404,16 +400,16 @@ RDC's
 RDMA
 RDNA
 README
-Recomputation
 RHEL
+RLHF
 RMW
 RNN
 RNNs
 ROC
 ROCProfiler
 ROCT
-ROCTx
 ROCTracer
+ROCTx
 ROCclr
 ROCdbgapi
 ROCgdb
@@ -428,8 +424,10 @@ RPP
 RST
 RW
 Radeon
+Recomputation
 RelWithDebInfo
 Req
+ResNet
 Rickle
 RoCE
 Runfile
@@ -437,8 +435,8 @@ Ryzen
 SALU
 SBIOS
 SCA
-ScaledGEMM
 SDK
+SDKs
 SDMA
 SDPA
 SDRAM
@@ -455,7 +453,6 @@ SKU
 SKUs
 SLES
 SLURM
-Slurm
 SMEM
 SMFMA
 SMI
@@ -466,17 +463,17 @@ SRAM
 SRAMECC
 SVD
 SWE
+ScaledGEMM
 SerDes
 ShareGPT
 Shlens
-simd
 Skylake
+Slurm
 Softmax
 Spack
 SplitK
 Supermicro
 Szegedy
-TagRAM
 TCA
 TCC
 TCCs
@@ -484,35 +481,33 @@ TCI
 TCIU
 TCP
 TCR
-TVM
-THREADGROUPS
-threadgroups
-TensorRT
-TensorFloat
 TF
 TFLOPS
+THREADGROUPS
 TP
 TPS
 TPU
 TPUs
 TSME
+TVM
+TagRAM
+Tagram
 Taichi
 Taichi's
-Tagram
 TensileLite
 TensorBoard
+TensorFloat
 TensorFlow
 TensorParallel
+TensorRT
+TheRock
 ToC
+TopK
 TorchAudio
-torchaudio
 TorchElastic
 TorchMIGraphX
-torchrec
 TorchScript
 TorchServe
-torchserve
-torchtext
 TorchVision
 TransferBench
 TrapStatus
@@ -524,17 +519,18 @@ UE
 UIF
 UMC
 USM
+USM
 UTCL
+UTCL
+UTIL
 UTIL
 UltraChat
 Uncached
-Unittests
 Unhandled
-unwindowed
+Unittests
 VALU
 VBIOS
 VCN
-verl's
 VGPR
 VGPRs
 VM
@@ -545,6 +541,7 @@ VSIX
 VSkipped
 Vanhoucke
 Vulkan
+WDAG
 WGP
 WGPs
 WR
@@ -553,7 +550,6 @@ WikiText
 Wojna
 Workgroups
 Writebacks
-xcc
 XCD
 XCDs
 XGBoost
@@ -573,8 +569,8 @@ ZeRO
 ZenDNN
 accuracies
 activations
-addr
 addEventListener
+addr
 ade
 ai
 alloc
@@ -585,6 +581,7 @@ amdgpu
 api
 aten
 atmi
+atomicRMW
 atomics
 autogenerated
 autotune
@@ -601,17 +598,16 @@ bilinear
 bitcode
 bitsandbytes
 bitwise
-Bitwise
 blit
 bootloader
 boson
 bosons
 br
-BrainFloat
 btn
 buildable
 bursty
 bzip
+cTDP
 cacheable
 carveout
 cd
@@ -626,6 +622,7 @@ cmd
 coalescable
 codename
 collater
+comfyui
 comgr
 compat
 completers
@@ -642,16 +639,18 @@ copyable
 cpp
 csn
 cuBLAS
-cuda
 cuDNN
-cudnn
 cuFFT
 cuLIB
 cuRAND
 cuSOLVER
 cuSPARSE
+cuda
+cudnn
 customizations
-cTDP
+dGPU
+dGPUs
+da
 dataset
 datasets
 dataspace
@@ -661,8 +660,9 @@ datatypes
 dbgapi
 de
 deallocation
-debuggability
 debian
+debuggability
+decompositions
 deepseek
 denoise
 denoised
@@ -677,10 +677,12 @@ devicelibs
 devsel
 dgl
 dimensionality
+disaggregated
 disambiguates
 distro
 distros
 dkms
+dropless
 dtype
 eb
 el
@@ -693,10 +695,14 @@ endpgm
 enqueue
 env
 epilog
+etcd
 etcetera
 ethernet
 exascale
 executables
+fam
+fam
+fas
 ffmpeg
 filesystem
 forEach
@@ -723,8 +729,8 @@ heterogenous
 hipBLAS
 hipBLASLt
 hipBLASLt's
-hipblaslt
 hipCUB
+hipDataType
 hipFFT
 hipFORT
 hipLIB
@@ -735,10 +741,12 @@ hipSPARSELt
 hipTensor
 hipamd
 hipblas
+hipblaslt
 hipcc
 hipcub
 hipfft
 hipfort
+hipification
 hipify
 hipsolver
 hipsparse
@@ -747,6 +755,7 @@ hostname
 hotspotting
 hpc
 hpp
+href
 hsa
 hsakmt
 hyperparameter
@@ -762,7 +771,9 @@ init
 initializer
 inlining
 installable
+instrSize
 interop
+interpolators
 interprocedural
 intra
 intrinsics
@@ -805,23 +816,21 @@ mjx
 mkdir
 mlirmiopen
 mtypes
+mul
 mutex
 mvffr
 namespace
 namespaces
 nanoGPT
-NCS
-NOP
-NVLink
 num
 numref
 ocl
+ol
 opencl
 opencv
 openmp
 openssl
 optimizers
-ol
 os
 oversubscription
 pageable
@@ -832,6 +841,7 @@ param
 parameterization
 passthrough
 pe
+perf
 perfcounter
 performant
 perl
@@ -864,8 +874,6 @@ pseudorandom
 px
 py
 pytorch
-recommender
-recommenders
 quantile
 quantizer
 quasirandom
@@ -878,6 +886,9 @@ rccl
 rdc
 rdma
 reStructuredText
+recommender
+recommenders
+redhat
 redirections
 refactorization
 reformats
@@ -891,7 +902,6 @@ rescaling
 reusability
 rhel
 rl
-RLHF
 roadmap
 roc
 rocAL
@@ -918,8 +928,8 @@ rocm
 rocminfo
 rocprim
 rocprof
-rocprofv
 rocprofiler
+rocprofv
 rocr
 rocrand
 rocsolver
@@ -929,7 +939,7 @@ roctracer
 rst
 runtime
 runtimes
-ResNet
+ryzen
 sL
 scalability
 scalable
@@ -944,6 +954,7 @@ sglang
 shader
 sharding
 sigmoid
+simd
 sles
 sm
 smi
@@ -964,6 +975,7 @@ submodule
 submodules
 subnet
 supercomputing
+suse
 symlink
 symlinks
 sys
@@ -973,6 +985,7 @@ td
 tensorfloat
 tf
 th
+threadgroups
 tokenization
 tokenize
 tokenized
@@ -982,16 +995,21 @@ toolchain
 toolchains
 toolset
 toolsets
+torchaudio
+torchrec
+torchserve
+torchtext
 torchtitan
 torchvision
 tp
 tqdm
 tracebacks
 txt
-TopK
 uarch
-uncached
+ubuntu
+udev
 uncacheable
+uncached
 uncorrectable
 underoptimized
 unhandled
@@ -1000,12 +1018,11 @@ unmapped
 unsqueeze
 unstacking
 unswitching
+untar
 untrusted
 untuned
+unwindowed
 upvote
-USM
-UTCL
-UTIL
 utils
 vL
 variational
@@ -1017,6 +1034,7 @@ vectorized
 vectorizer
 vectorizes
 verl
+verl's
 virtualize
 virtualized
 vjxb
@@ -1035,9 +1053,12 @@ writeback
 writebacks
 wrreq
 wzo
-xargs
+xDiT
 xGMI
 xPacked
+xargs
+xcc
+xdit
 xz
 yaml
 ysvmadyb
--- a/RELEASE.md
+++ b/RELEASE.md
--- a/docs/compatibility/compatibility-matrix.rst
+++ b/docs/compatibility/compatibility-matrix.rst
@@ -0,0 +1,111 @@
+****************************************
+ROCm |ROCM_VERSION| compatibility matrix
+****************************************
+
+To plan your ROCm |ROCM_VERSION| installation, use the following selector to
+view ROCm compatibility and system requirements information for your AMD
+hardware configuration. For installation instructions, see
+:doc:`/install/rocm`.
+
+.. include:: ./includes/selector.rst
+
+----
+
+Hardware, software, and firmware requirements
+=============================================
+
+ROCm depends on a coordinated stack of compatible firmware, driver, and user
+space components. Maintaining version alignment between these layers ensures
+expected GPU operation and performance, especially for AMD data center products.
+Future preview releases will expand hardware and operating system coverage.
+
+ROCm 7.10.0 enables support for primarily compute workloads. Future releases
+will support mixed workloads (compute and graphics).
+
+.. selected:: os=ubuntu os=rhel os=sles
+
+   .. selected:: fam=radeon-pro fam=radeon
+
+      If you’re interested in testing AMD Radeon™ GPUs with preview support for
+      graphics use cases with AMD ROCm 7.10.0, install Radeon Software for Linux
+      version 25.30.1 from `Linux Drivers for AMD Radeon and Radeon PRO
+      Graphics <https://www.amd.com/en/support/download/linux-drivers.html>`__.
+
+   .. selected:: fam=ryzen
+
+      If you're interested in testing AMD Ryzen™ APUs with preview support for
+      graphics use cases with AMD ROCm 7.10.0, use the inbox graphics drivers of
+      Ubuntu 24.04.3.
+
+.. include:: ./includes/system-instinct.rst
+
+.. include:: ./includes/system-radeon-pro.rst
+
+.. include:: ./includes/system-radeon.rst
+
+.. include:: ./includes/system-ryzen.rst
+
+----
+
+.. _rocm-compat-frameworks:
+
+Deep learning frameworks
+========================
+
+ROCm |ROCM_VERSION| provides optimized support for popular deep learning
+frameworks. The following table lists supported frameworks and their supported
+versions.
+
+.. _rocm-compat-pytorch:
+
+.. matrix::
+
+   .. matrix-head::
+
+      .. matrix-row::
+
+         .. matrix-cell:: Framework
+            :header:
+
+         .. matrix-cell:: Supported versions
+            :header:
+
+   .. matrix-row::
+      :show-when: fam=instinct fam=ryzen
+
+      .. matrix-cell:: PyTorch
+
+      .. matrix-cell:: 2.9.1, 2.8.0, 2.7.1
+         :show-when: os=ubuntu os=rhel os=sles
+
+      .. matrix-cell:: 2.9.1
+         :show-when: os=windows
+
+   .. matrix-row::
+      :show-when: fam=radeon fam=radeon-pro
+
+      .. matrix-cell:: PyTorch
+
+      .. matrix-cell:: 2.9.1
+
+For installation instructions, see :ref:`pip-install-pytorch`.
+
+.. _rocm-compat-python:
+
+.. note::
+
+   ROCm |ROCM_VERSION| is compatible with Python versions **3.11**, **3.12**,
+   and **3.13**.
+
+----
+
+ROCm Core SDK components
+========================
+
+The following table lists core components included in the ROCm |ROCM_VERSION|
+release. Expect future releases in this stream to expand the list of
+components.
+
+.. include:: ./includes/core-sdk-components-linux.rst
+
+.. include:: ./includes/core-sdk-components-windows.rst
--- a/docs/compatibility/includes/core-sdk-components-linux.rst
+++ b/docs/compatibility/includes/core-sdk-components-linux.rst
@@ -0,0 +1,214 @@
+.. matrix::
+   :show-when: os=ubuntu os=rhel os=sles
+
+   .. matrix-head::
+
+      .. matrix-row::
+         :header:
+
+         .. matrix-cell:: Component group
+
+         .. matrix-cell:: Component name
+
+   .. matrix-row::
+
+      .. matrix-cell:: Runtimes and compilers
+         :rowspan: 5
+
+      .. matrix-cell::
+
+         `HIP <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/hip>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `HIPIFY <https://github.com/ROCm/HIPIFY/tree/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `LLVM <https://github.com/ROCm/llvm-project/tree/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `ROCr Runtime <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/rocr-runtime>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `SPIRV-LLVM-Translator <https://github.com/ROCm/SPIRV-LLVM-Translator/tree/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Control and monitoring tools
+         :rowspan: 2
+
+      .. matrix-cell::
+
+         `AMD SMI <https://github.com/ROCm/amdsmi/tree/release/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocminfo <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/rocminfo>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Profiling and debugging tools
+         :rowspan: 3
+         :show-when: fam=instinct
+
+      .. matrix-cell:: Profiling and debugging tools
+         :rowspan: 2
+         :show-when: fam=radeon-pro fam=radeon fam=ryzen
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `ROCm Compute Profiler (rocprofiler-compute) <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/rocprofiler-compute>`__
+
+   .. matrix-row::
+      :show-when: fam=instinct
+
+      .. matrix-cell::
+
+         `ROCprofiler-SDK <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/rocprofiler-sdk>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Math and compute libraries
+         :rowspan: 18
+         :show-when: fam=instinct
+
+      .. matrix-cell:: Math and compute libraries
+         :rowspan: 17
+         :show-when: fam=radeon-pro fam=radeon fam=ryzen
+
+      .. matrix-cell::
+
+         `rocBLAS <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocblas>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipBLAS <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipblas>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipBLASLt <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipblaslt>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocFFT <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocfft>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipFFT <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipfft>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocRAND <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocrand>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipRAND <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hiprand>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocSOLVER <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocsolver>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipSOLVER <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipsolver>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocSPARSE <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocsparse>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipSPARSE <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipsparse>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipSPARSELt <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipsparselt>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocPRIM <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocprim>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocThrust <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocthrust>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipCUB <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipcub>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocWMMA <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocwmma>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `Composable Kernel <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/composablekernel>`__ (partial, limited support)
+
+   .. matrix-row::
+      :show-when: fam=instinct
+
+      .. matrix-cell::
+
+         `MIOpen <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/miopen>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Communication librarires
+
+      .. matrix-cell::
+
+         `RCCL <https://github.com/ROCm/rccl/tree/release/therock-7.10>`__
+   .. matrix-row::
+
+      .. matrix-cell:: Support libraries
+
+      .. matrix-cell::
+
+         `ROCm CMake <https://github.com/ROCm/rocm-cmake/tree/therock-7.10>`__
--- a/docs/compatibility/includes/core-sdk-components-windows.rst
+++ b/docs/compatibility/includes/core-sdk-components-windows.rst
@@ -0,0 +1,139 @@
+.. matrix::
+   :show-when: os=windows
+
+   .. matrix-head::
+
+      .. matrix-row::
+         :header:
+
+         .. matrix-cell:: Component group
+
+         .. matrix-cell:: Component name
+
+   .. matrix-row::
+
+      .. matrix-cell:: Runtimes and compilers
+         :rowspan: 3
+
+      .. matrix-cell::
+
+         `HIP <https://github.com/ROCm/rocm-systems/tree/therock-7.10/projects/hip>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `HIPIFY <https://github.com/ROCm/HIPIFY/tree/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `LLVM <https://github.com/ROCm/llvm-project/tree/therock-7.10>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Control and monitoring tools
+
+      .. matrix-cell:: hipinfo
+
+   .. matrix-row::
+
+      .. matrix-cell:: Math and compute libraries
+         :rowspan: 15
+
+      .. matrix-cell::
+
+         `rocBLAS <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocblas>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipBLAS <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipblas>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipBLASLt <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipblaslt>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocFFT <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocfft>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipFFT <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipfft>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocRAND <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocrand>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipRAND <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocsolver>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocSOLVER <https://github.com/ROCm/rocm-libraries/tree/therock-7.9.0/projects/rocsolver>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipSOLVER <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipsolver>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocSPARSE <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocsparse>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipSPARSE <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipsparse>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocPRIM <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocprim>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocThrust <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocthrust>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `hipCUB <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/hipcub>`__
+
+   .. matrix-row::
+
+      .. matrix-cell::
+
+         `rocWMMA <https://github.com/ROCm/rocm-libraries/tree/therock-7.10/projects/rocwmma>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Support libraries
+
+      .. matrix-cell::
+
+         `ROCm CMake <https://github.com/ROCm/rocm-cmake/tree/therock-7.10>`__
--- a/docs/compatibility/includes/selector.rst
+++ b/docs/compatibility/includes/selector.rst
@@ -0,0 +1,128 @@
+.. selector:: AMD device family
+   :key: fam
+
+   .. selector-option:: Instinct
+      :value: instinct
+      :width: 3
+
+   .. selector-option:: Radeon PRO
+      :value: radeon-pro
+      :width: 3
+
+   .. selector-option:: Radeon RX
+      :value: radeon
+      :width: 3
+
+   .. selector-option:: Ryzen AI
+      :value: ryzen
+      :width: 3
+
+.. selector:: Instinct GPU
+   :key: gfx
+   :show-when: fam=instinct
+
+   .. selector-info:: https://www.amd.com/en/products/accelerators/instinct.html
+
+   .. selector-option:: Instinct MI355X<br>Instinct MI350X
+      :value: 950
+      :width: 4
+
+   .. selector-option:: Instinct MI325X<br>Instinct MI300X<br>Instinct MI300A
+      :value: 942
+      :width: 4
+
+   .. selector-option:: Instinct MI250X<br>Instinct MI250<br>Instinct MI210
+      :value: 90a
+      :width: 4
+
+.. selector:: Radeon PRO GPU
+   :key: gfx
+   :show-when: fam=radeon-pro
+
+   .. selector-info:: https://www.amd.com/en/products/graphics/workstations.html
+
+   .. selector-option:: Radeon PRO W7900D<br>Radeon PRO W7900<br>Radeon PRO W7800 48GB<br>Radeon PRO W7800
+      :value: 1100
+      :width: 6
+
+   .. selector-option:: Radeon PRO W7700
+      :value: 1101
+      :width: 6
+
+.. selector:: Radeon RX GPU
+   :key: gfx
+   :show-when: fam=radeon
+
+   .. selector-info:: https://www.amd.com/en/products/graphics/desktops/radeon.html
+
+   .. selector-option:: Radeon RX 7900 XTX<br>Radeon RX 7900 XT<br>Radeon RX 7900 GRE
+      :value: 1100
+
+   .. selector-option:: Radeon RX 7800 XT<br>Radeon RX 7700 XT
+      :value: 1101
+
+.. selector:: Ryzen AI APU
+   :key: gfx
+   :show-when: fam=ryzen
+
+   .. selector-info:: https://www.amd.com/en/products/processors/workstations/mobile.html
+
+   .. selector-option:: Ryzen AI Max+ PRO 395<br>Ryzen AI Max PRO 390, 385, 380<br>Ryzen AI Max+ 395<br>Ryzen AI Max 390, 385
+      :value: 1151
+      :width: 6
+
+   .. selector-option:: Ryzen AI 9 HX 375<br>Ryzen AI 9 HX 370<br>Ryzen AI 9 365
+      :value: 1150
+      :width: 6
+
+.. selector:: Operating system
+   :key: os
+   :show-when: fam=instinct
+
+   .. selector-option:: Ubuntu
+      :value: ubuntu
+      :icon: fab fa-ubuntu fa-lg
+      :width: 4
+
+   .. selector-option:: RHEL
+      :value: rhel
+      :icon: fab fa-redhat fa-lg
+      :width: 4
+
+   .. selector-option:: SLES
+      :value: sles
+      :icon: fab fa-suse fa-lg
+      :width: 4
+
+.. selector:: Operating system
+   :key: os
+   :show-when: fam=radeon-pro fam=radeon
+
+   .. selector-option:: Ubuntu
+      :value: ubuntu
+      :icon: fab fa-ubuntu fa-lg
+      :width: 4
+
+   .. selector-option:: RHEL
+      :value: rhel
+      :icon: fab fa-redhat fa-lg
+      :width: 4
+
+   .. selector-option:: Windows
+      :value: windows
+      :icon: fab fa-windows fa-lg
+      :width: 4
+
+.. selector:: Operating system
+   :key: os
+   :show-when: fam=ryzen
+
+   .. selector-option:: Ubuntu
+      :value: ubuntu
+      :icon: fab fa-ubuntu fa-lg
+      :width: 6
+
+   .. selector-option:: Windows
+      :value: windows
+      :icon: fab fa-windows fa-lg
+      :width: 6
--- a/docs/compatibility/includes/system-instinct.rst
+++ b/docs/compatibility/includes/system-instinct.rst
@@ -0,0 +1,147 @@
+.. matrix::
+   :show-when: fam=instinct
+
+   .. matrix-row::
+      :show-when: gfx=950
+
+      .. matrix-cell:: AMD Instinct MI350 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Instinct MI355X <https://www.amd.com/en/products/accelerators/instinct/mi350/mi355x.html>`__
+
+         `Instinct MI350X <https://www.amd.com/en/products/accelerators/instinct/mi350/mi350x.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=942
+
+      .. matrix-cell:: AMD Instinct MI300 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Instinct MI325X <https://www.amd.com/en/products/accelerators/instinct/mi300/mi325x.html>`__
+
+         `Instinct MI300X <https://www.amd.com/en/products/accelerators/instinct/mi300/mi300x.html>`__
+
+         `Instinct MI300A <https://www.amd.com/en/products/accelerators/instinct/mi300/mi300a.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=90a
+
+      .. matrix-cell:: AMD Instinct MI200 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Instinct MI250X <https://www.amd.com/en/products/accelerators/instinct/mi200/mi250x.html>`__
+
+         `Instinct MI250 <https://www.amd.com/en/products/accelerators/instinct/mi200/mi250.html>`__
+
+         `Instinct MI210 <https://www.amd.com/en/products/accelerators/instinct/mi200/mi210.html>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Architecture
+         :header:
+
+      .. matrix-cell:: CDNA 4
+         :show-when: gfx=950
+
+      .. matrix-cell:: CDNA 3
+         :show-when: gfx=942
+
+      .. matrix-cell:: CDNA 2
+         :show-when: gfx=90a
+
+   .. matrix-row::
+
+      .. matrix-cell:: LLVM target
+         :header:
+
+      .. matrix-cell:: gfx950
+         :show-when: gfx=950
+
+      .. matrix-cell:: gfx942
+         :show-when: gfx=942
+
+      .. matrix-cell:: gfx90a
+         :show-when: gfx=90a
+
+   .. matrix-row::
+      :show-when: os=ubuntu
+
+      .. matrix-cell:: Supported Ubuntu versions
+         :header:
+
+      .. matrix-cell::
+
+         Ubuntu 24.04.3 (GA kernel: 6.8)
+
+         Ubuntu 22.04.5 (GA kernel: 5.15)
+
+   .. matrix-row::
+      :show-when: os=rhel
+
+      .. matrix-cell:: Supported Red Hat Enterprise Linux versions
+         :header:
+
+      .. matrix-cell::
+
+	 RHEL 10.1 (kernel: 6.12.0-124)
+
+	 RHEL 10.0 (kernel: 6.12.0-55)
+
+	 RHEL 9.7 (kernel: 5.14.0-611)
+
+	 RHEL 9.6 (kernel: 5.14.0-570)
+
+	 RHEL 8.10 (kernel: 4.18.0-553)
+
+   .. matrix-row::
+      :show-when: os=sles
+
+      .. matrix-cell:: Supported SUSE Linux Enterprise Server version
+         :header:
+
+      .. matrix-cell:: SLES 15.7 (kernel: 6.4.0-150700.51)
+
+   .. matrix-row::
+
+      .. matrix-cell:: Supported AMD GPU Driver (amdgpu) versions
+         :header:
+
+      .. matrix-cell:: 
+
+         `30.20.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.20.0/>`__,
+         `30.10.2 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.2/>`__,
+         `30.10.1 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.1/>`__,
+         `30.10.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10/>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Supported PLDM bundle (firmware) versions
+         :header:
+
+      .. matrix-cell:: 01.25.15.04, 01.25.13.09
+         :show-when: gfx=950
+
+      .. matrix-cell::
+         :show-when: gfx=942
+
+         **MI325X** 01.25.04.02, 01.25.03.03
+
+         **MI300X** 01.25.05.00 (or later), 01.25.03.12
+
+         **MI300A** BKC 26, 25
+
+      .. matrix-cell::
+         :show-when: gfx=90a
+
+         **MI250X** IFWI 47 (or later)
+
+         **MI250** Maintenance update 5 with IFWI 75 (or later)
+
+         **MI210** Maintenance update 5 with IFWI 75 (or later)
+
--- a/docs/compatibility/includes/system-radeon-pro.rst
+++ b/docs/compatibility/includes/system-radeon-pro.rst
@@ -0,0 +1,111 @@
+.. matrix::
+   :show-when: fam=radeon-pro
+
+   .. matrix-row::
+      :show-when: gfx=1100
+
+      .. matrix-cell:: AMD Radeon PRO W7000 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Radeon PRO W7900D <https://www.amd.com/en/support/downloads/drivers.html/graphics/radeon-pro/radeon-pro-w7000-series/amd-radeon-pro-w7900d.html>`__
+
+         `Radeon PRO W7900 <https://www.amd.com/en/products/graphics/workstations/radeon-pro/w7900.html>`__
+
+         `Radeon PRO W7800 48GB <https://www.amd.com/en/products/graphics/workstations/radeon-pro/w7800-48gb.html>`__
+
+         `Radeon PRO W7800 <https://www.amd.com/en/products/graphics/workstations/radeon-pro/w7800.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=1101
+
+      .. matrix-cell:: AMD Radeon PRO W7000 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Radeon PRO W7700 <https://www.amd.com/en/products/graphics/workstations/radeon-pro/w7700.html>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Architecture
+         :header:
+
+      .. matrix-cell:: RDNA 3
+
+   .. matrix-row::
+
+      .. matrix-cell:: LLVM target
+         :header:
+
+      .. matrix-cell:: gfx1101
+         :show-when: gfx=1101
+
+      .. matrix-cell:: gfx1100
+         :show-when: gfx=1100
+
+   .. matrix-row::
+      :show-when: os=ubuntu
+
+      .. matrix-cell:: Supported Ubuntu versions
+         :header:
+
+      .. matrix-cell::
+
+         24.04.3 (GA kernel: 6.8)
+
+         22.04.5 (GA kernel: 5.15)
+
+   .. matrix-row::
+      :show-when: os=rhel
+
+      .. matrix-cell:: Supported RHEL versions
+         :header:
+
+      .. matrix-cell:: 10.1, 10.0
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Windows version
+         :header:
+
+      .. matrix-cell:: Windows 11 25H2
+
+   .. matrix-row::
+
+      .. matrix-cell:: Supported AMD GPU Driver (amdgpu) versions
+         :header:
+
+      .. matrix-cell:: 
+
+         `30.20.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.20.0/>`__,
+         `30.10.2 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.2/>`__,
+         `30.10.1 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.1/>`__,
+         `30.10.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10/>`__
+
+   .. matrix-row::
+      :show-when: os=ubuntu os=rhel os=sles
+
+      .. matrix-cell:: Supported Radeon Software for Linux version
+         :header:
+
+      .. matrix-cell::
+
+         `25.30.1 <https://www.amd.com/en/support/download/linux-drivers.html#linux-for-radeon-pro>`__
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Adrenalin Driver version
+         :header:
+
+      .. matrix-cell::
+
+         `25.11.1 <https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-11-1.html>`__
+         (generally recommended)
+
+         `25.20.01.17 <https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__
+         (recommended for ComfyUI)
+
--- a/docs/compatibility/includes/system-radeon.rst
+++ b/docs/compatibility/includes/system-radeon.rst
@@ -0,0 +1,112 @@
+.. matrix::
+   :show-when: fam=radeon
+
+   .. matrix-row::
+      :show-when: gfx=1100
+
+      .. matrix-cell:: AMD Radeon RX 7000 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Radeon RX 7900 XTX <https://www.amd.com/en/products/graphics/desktops/radeon/7000-series/amd-radeon-rx-7900xtx.html>`__
+
+         `Radeon RX 7900 XT <https://www.amd.com/en/products/graphics/desktops/radeon/7000-series/amd-radeon-rx-7900xt.html>`__
+
+         `Radeon RX 7900 GRE <https://www.amd.com/en/products/graphics/desktops/radeon/7000-series/amd-radeon-rx-7900-gre.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=1101
+
+      .. matrix-cell:: AMD Radeon RX 7000 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Radeon RX 7800 XT <https://www.amd.com/en/products/graphics/desktops/radeon/7000-series/amd-radeon-rx-7800-xt.html>`__
+
+         `Radeon RX 7700 XT <https://www.amd.com/en/products/graphics/desktops/radeon/7000-series/amd-radeon-rx-7700-xt.html>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Architecture
+         :header:
+
+      .. matrix-cell:: RDNA 3
+         :show-when: gfx=1101 gfx=1100
+
+   .. matrix-row::
+
+      .. matrix-cell:: LLVM target
+         :header:
+
+      .. matrix-cell:: gfx1100
+         :show-when: gfx=1100
+
+      .. matrix-cell:: gfx1101
+         :show-when: gfx=1101
+
+   .. matrix-row::
+      :show-when: os=ubuntu
+
+      .. matrix-cell:: Supported Ubuntu versions
+         :header:
+
+      .. matrix-cell::
+
+         24.04.3 (GA kernel: 6.8)
+
+         22.04.5 (GA kernel: 5.15)
+
+   .. matrix-row::
+      :show-when: os=rhel
+
+      .. matrix-cell:: Supported RHEL versions
+         :header:
+
+      .. matrix-cell:: 10.1, 10.0
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Windows version
+         :header:
+
+      .. matrix-cell:: Windows 11 25H2
+
+   .. matrix-row::
+
+      .. matrix-cell:: Supported AMD GPU Driver (amdgpu) versions
+         :header:
+
+      .. matrix-cell:: 
+
+         `30.20.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.20.0/>`__,
+         `30.10.2 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.2/>`__,
+         `30.10.1 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10.1/>`__,
+         `30.10.0 <https://instinct.docs.amd.com/projects/amdgpu-docs/en/docs-30.10/>`__
+
+   .. matrix-row::
+      :show-when: os=ubuntu os=rhel os=sles
+
+      .. matrix-cell:: Supported Radeon Software for Linux version
+         :header:
+
+      .. matrix-cell::
+
+         `25.30.1 <https://www.amd.com/en/support/download/linux-drivers.html#linux-for-radeon-pro>`__
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Adrenalin Driver version
+         :header:
+
+      .. matrix-cell::
+
+         `25.11.1 <https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-11-1.html>`__
+         (generally recommended)
+
+         `25.20.01.17 <https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__
+         (recommended for ComfyUI)
+
--- a/docs/compatibility/includes/system-ryzen.rst
+++ b/docs/compatibility/includes/system-ryzen.rst
@@ -0,0 +1,103 @@
+.. matrix::
+   :show-when: fam=ryzen
+
+   .. matrix-row::
+      :show-when: gfx=1151
+
+      .. matrix-cell:: AMD Ryzen AI Max PRO 300 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Ryzen AI Max+ PRO 395 <https://www.amd.com/en/products/processors/laptop/ryzen-pro/ai-max-pro-300-series/amd-ryzen-ai-max-plus-pro-395.html>`__
+
+         `Ryzen AI Max PRO 390 <https://www.amd.com/en/products/processors/laptop/ryzen-pro/ai-max-pro-300-series/amd-ryzen-ai-max-pro-390.html>`__
+
+         `Ryzen AI Max PRO 385 <https://www.amd.com/en/products/processors/laptop/ryzen-pro/ai-max-pro-300-series/amd-ryzen-ai-max-pro-385.html>`__
+
+         `Ryzen AI Max PRO 380 <https://www.amd.com/en/products/processors/laptop/ryzen-pro/ai-max-pro-300-series/amd-ryzen-ai-max-pro-380.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=1151
+
+      .. matrix-cell:: AMD Ryzen AI Max 300 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Ryzen AI Max+ 395 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-max-plus-395.html>`__
+
+         `Ryzen AI Max 390 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-max-390.html>`__
+
+         `Ryzen AI Max 385 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-max-385.html>`__
+
+   .. matrix-row::
+      :show-when: gfx=1150
+
+      .. matrix-cell:: AMD Ryzen AI 300 Series
+         :header:
+
+      .. matrix-cell::
+
+         `Ryzen AI 9 HX 375 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-9-hx-375.html>`__
+
+         `Ryzen AI 9 HX 370 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-9-hx-370.html>`__
+
+         `Ryzen AI 9 365 <https://www.amd.com/en/products/processors/laptop/ryzen/ai-300-series/amd-ryzen-ai-9-365.html>`__
+
+   .. matrix-row::
+
+      .. matrix-cell:: Architecture
+         :header:
+
+      .. matrix-cell:: RDNA 3.5
+
+   .. matrix-row::
+
+      .. matrix-cell:: LLVM target
+         :header:
+
+      .. matrix-cell:: gfx1151
+         :show-when: gfx=1151
+
+      .. matrix-cell:: gfx1150
+         :show-when: gfx=1150
+
+   .. matrix-row::
+      :show-when: os=ubuntu
+
+      .. matrix-cell:: Supported Ubuntu versions
+         :header:
+
+      .. matrix-cell:: 24.04.3 (HWE kernel: 6.14)
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Windows version
+         :header:
+
+      .. matrix-cell:: Windows 11 25H2
+
+   .. matrix-row::
+      :show-when: os=ubuntu
+
+      .. matrix-cell:: Supported kernel driver version
+         :header:
+
+      .. matrix-cell:: Inbox kernel driver in Ubuntu 24.04.3
+
+   .. matrix-row::
+      :show-when: os=windows
+
+      .. matrix-cell:: Supported Adrenalin Driver version
+         :header:
+
+      .. matrix-cell::
+
+         `25.11.1 <https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-11-1.html>`__
+         (generally recommended)
+
+         `25.20.01.17 <https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__
+         (recommended for ComfyUI)
+
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -9,8 +9,8 @@ import shutil
 import sys
 from pathlib import Path

-ROCM_VERSION = "7.9.0"
-GA_DATE = "2025-10-20"
+ROCM_VERSION = "7.10.0"
+GA_DATE = "2025-12-11"

 DOCS_DIR = Path(__file__).parent.resolve()
 ROOT_DIR = DOCS_DIR.parent
@@ -102,46 +102,40 @@ html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "rocm.docs.amd.com")
 html_context = {}

 # configurations for PDF output by Read the Docs
-project = "ROCm Documentation"
+project = "ROCm documentation"
 project_path = str(DOCS_DIR).replace("\\", "/")
 author = "Advanced Micro Devices, Inc."
 copyright = "Copyright (c) %Y Advanced Micro Devices, Inc. All rights reserved."
 version = ROCM_VERSION
 release = ROCM_VERSION
-setting_all_article_info = True
+setting_all_article_info = False
 all_article_info_os = ["linux", "windows"]
 all_article_info_author = ""

 # pages with specific settings
 article_pages = [
-    {"file": "about/release-notes", "date": GA_DATE},
+    {"file": "about/release-notes", "date": GA_DATE, "os": ["linux", "windows"]},
 ]

 external_toc_path = "./sphinx/_toc.yml"

 # Register Sphinx extensions and static assets
 sys.path.append(str(DOCS_DIR / "extension"))
-
-# html_static_path = ["sphinx/static/css", "extension/how-to/rocm-for-ai/inference"]
-# html_css_files = [
-    # "rocm_custom.css",
-    # "rocm_rn.css",
-    # "dynamic_picker.css",
-    # "vllm-benchmark.css",
-# ]
-templates_path = ["extension/rocm_docs_custom/templates", "extension/templates"]
-
 extensions = [
    "rocm_docs",
    "rocm_docs_custom.selector",
-    "rocm_docs_custom.table",
+    "rocm_docs_custom.matrix",
    "rocm_docs_custom.icon",
+    # "sphinxcontrib.datatemplates",
    # "sphinx_reredirects",
    # "sphinx_sitemap",
-    # "sphinxcontrib.datatemplates",
    # "version-ref",
    # "csv-to-list-table",
 ]
+templates_path = ["extension/rocm_docs_custom/templates"]
+
+html_static_path = ["sphinx/static"]
+html_js_files = ["setup-toc-install-headings.js"]

 # compatibility_matrix_file = str(
 #     DOCS_DIR / "compatibility/compatibility-matrix-historical-6.0.csv"
@@ -150,17 +144,33 @@ extensions = [
 external_projects_current_project = "rocm"
 html_theme = "rocm_docs_theme"
 html_theme_options = {
-    "flavor": "rocm-docs-home",
+    "announcement": f"This is ROCm {ROCM_VERSION} technology preview release documentation. For the latest production stream release, refer to <a id='rocm-banner' href='https://rocm.docs.amd.com/en/latest/'>ROCm documentation</a>.",
+    "flavor": "generic",
+    "header_title": f"ROCm™ {ROCM_VERSION} Preview",
+    "header_link": f"https://rocm.docs.amd.com/en/{ROCM_VERSION}-preview/index.html",
+    "version_list_link": f"https://rocm.docs.amd.com/en/{ROCM_VERSION}-preview/release/versions.html",
+    "nav_secondary_items": {
+        "GitHub": "https://github.com/ROCm/ROCm",
+        "Community": "https://github.com/ROCm/ROCm/discussions",
+        "Blogs": "https://rocm.blogs.amd.com/",
+        "Instinct™ Docs": "https://instinct.docs.amd.com/",
+        "Support": "https://github.com/ROCm/ROCm/issues/new/choose",
+    },
    "link_main_doc": False,
    "secondary_sidebar_items": {
        "**": ["page-toc"],
+        "compatibility/compatibility-matrix": ["selector-toc2"],
        "install/rocm": ["selector-toc2"],
-        "install/compatibility-matrix": ["selector-toc2"],
-    }
+        "rocm-for-ai/pytorch-comfyui": ["selector-toc2"],
+    },
 }
 html_title = f"AMD ROCm {ROCM_VERSION} preview"

 numfig = False
+rst_prolog = f"""
+.. |ROCM_VERSION| replace:: {ROCM_VERSION}
+"""
+
 suppress_warnings = ["autosectionlabel.*"]

 # html_baseurl = os.environ.get("READTHEDOCS_CANONICAL_URL", "https://rocm-stg.amd.com/")
--- a/docs/data/comfyui.png
+++ b/docs/data/comfyui.png
--- a/docs/data/comfyui/chroma1-radiance-tti-card.png
+++ b/docs/data/comfyui/chroma1-radiance-tti-card.png
--- a/docs/data/comfyui/chroma1-radiance-tti-missing-models.png
+++ b/docs/data/comfyui/chroma1-radiance-tti-missing-models.png
--- a/docs/data/comfyui/comfyui-main.png
+++ b/docs/data/comfyui/comfyui-main.png
--- a/docs/data/comfyui/sd3_5-missing-models.png
+++ b/docs/data/comfyui/sd3_5-missing-models.png
--- a/docs/data/comfyui/sd3_5-simple-card.png
+++ b/docs/data/comfyui/sd3_5-simple-card.png
--- a/docs/data/rocm-ontology.png
+++ b/docs/data/rocm-ontology.png
--- a/docs/data/rocm-software-stack-6_3_1.jpg
+++ b/docs/data/rocm-software-stack-6_3_1.jpg
--- a/docs/data/rocm-software-stack-6_3_2.jpg
+++ b/docs/data/rocm-software-stack-6_3_2.jpg
--- a/docs/data/rocm-software-stack-6_4_0.jpg
+++ b/docs/data/rocm-software-stack-6_4_0.jpg
--- a/docs/data/rocm-software-stack-7_0_0.jpg
+++ b/docs/data/rocm-software-stack-7_0_0.jpg
--- a/docs/extension/rocm_docs_custom/matrix.py
+++ b/docs/extension/rocm_docs_custom/matrix.py
@@ -0,0 +1,289 @@
+from pathlib import Path
+
+from docutils import nodes
+from docutils.parsers.rst import directives
+from sphinx.util.docutils import SphinxDirective
+
+from .utils import kv_to_data_attr, logger
+
+
+class CustomTable(nodes.General, nodes.Element):
+    """Bootstrap-flavoured table container."""
+
+    @staticmethod
+    def visit_html(translator, node):
+        show_when_attr = kv_to_data_attr("show-when", node.get("show-when", ""))
+
+        classes = ["rocm-docs-table", "table"]
+        classes.extend(node.get("classes", []))
+        class_attr = " ".join(classes)
+        table_id = node.get("id") or ""
+
+        attrs = []
+        if table_id:
+            attrs.append(f'id="{table_id}"')
+        attrs.append(f'class="{class_attr}"')
+        if show_when_attr:
+            attrs.append(show_when_attr)
+
+        attrs_str = " ".join(attrs)
+        translator.body.append(f"<!-- start custom-table --><table {attrs_str}>")
+
+        caption = node.get("caption", "")
+        if caption:
+            translator.body.append(f"<caption>{caption}</caption>")
+
+        translator._in_matrix_body = False  # internal state flag
+
+    @staticmethod
+    def depart_html(translator, node):
+        # Close an open <tbody> if present
+        if getattr(translator, "_in_matrix_body", False):
+            translator.body.append("</tbody>")
+            translator._in_matrix_body = False
+
+        translator.body.append("</table><!-- end custom-table -->")
+
+
+class CustomTableDirective(SphinxDirective):
+    """.. matrix:: Optional caption"""
+
+    required_arguments = 0
+    optional_arguments = 1
+    final_argument_whitespace = True
+    has_content = True
+    option_spec = {
+        "id": directives.unchanged,
+        "class": directives.class_option,
+        "show-when": directives.unchanged,
+    }
+
+    def run(self):
+        node = CustomTable()
+        node["caption"] = self.arguments[0] if self.arguments else ""
+        node["id"] = self.options.get("id", "")
+        node["classes"] = self.options.get("class", [])
+        node["show-when"] = self.options.get("show-when", "")
+        self.state.nested_parse(self.content, self.content_offset, node)
+        return [node]
+
+
+class CustomTableHead(nodes.General, nodes.Element):
+    """A table header section (renders <thead>).</thead>"""
+
+    @staticmethod
+    def visit_html(translator, node):
+        translator.body.append("<!-- start table head --><thead>")
+
+    @staticmethod
+    def depart_html(translator, node):
+        translator.body.append("</thead><!-- end table head -->")
+
+
+class CustomTableHeadDirective(SphinxDirective):
+    """.. matrix-head::"""
+
+    has_content = True
+
+    def run(self):
+        node = CustomTableHead()
+        self.state.nested_parse(self.content, self.content_offset, node)
+        return [node]
+
+
+class CustomTableRow(nodes.General, nodes.Element):
+    """A table row (<tr> inside <thead> or <tbody>)."""
+
+    @staticmethod
+    def visit_html(translator, node):
+        # handle automatic <tbody> opening for body rows
+        if not node.get("header-row", False):
+            if not getattr(translator, "_in_matrix_body", False):
+                translator.body.append("<!-- start tbody --><tbody>")
+                translator._in_matrix_body = True
+
+        show_when_attr = kv_to_data_attr("show-when", node.get("show-when", ""))
+        disable_when_attr = kv_to_data_attr(
+            "disable-when", node.get("disable-when", "")
+        )
+
+        classes = " ".join(node.get("classes", []))
+        attrs = []
+        if classes:
+            attrs.append(f'class="{classes}"')
+        if show_when_attr:
+            attrs.append(show_when_attr)
+        if disable_when_attr:
+            attrs.append(disable_when_attr)
+
+        attrs_str = "" if not attrs else " " + " ".join(attrs)
+        translator.body.append(f"<!-- start custom-table row --><tr{attrs_str}>")
+
+    @staticmethod
+    def depart_html(translator, node):
+        translator.body.append("</tr><!-- end custom-table row -->")
+
+
+class CustomTableRowDirective(SphinxDirective):
+    """.. matrix-row::"""
+
+    required_arguments = 0
+    final_argument_whitespace = True
+    has_content = True
+    option_spec = {
+        "class": directives.class_option,
+        "show-when": directives.unchanged,
+        "disable-when": directives.unchanged,
+        "header": directives.flag,
+    }
+
+    def run(self):
+        node = CustomTableRow()
+        node["classes"] = self.options.get("class", [])
+        node["show-when"] = self.options.get("show-when", "")
+        node["disable-when"] = self.options.get("disable-when", "")
+        node["header-row"] = self.options.get("header", False) is not False
+
+        # Parse nested cells
+        self.state.nested_parse(self.content, self.content_offset, node)
+
+        # Inherit header status if inside matrix-head
+        parent_in_head = any(
+            isinstance(p, CustomTableHead)
+            for p in self.state.parent.traverse(include_self=True)
+        )
+        if parent_in_head:
+            node["header-row"] = True
+
+        # Mark all cells as headers if this is a header row
+        if node["header-row"]:
+            for cell in node.findall(CustomTableCell):
+                if "header" not in cell:
+                    cell["header"] = True
+
+        # Sanity check
+        parent = getattr(self.state, "parent", None)
+        if not parent or not any(
+            isinstance(p, (CustomTable, CustomTableHead))
+            for p in parent.traverse(include_self=True)
+        ):
+            logger.warning(
+                "'.. matrix-row::' at line %s should be nested under a '.. matrix::'.",
+                self.lineno,
+                location=(self.env.docname, self.lineno),
+            )
+
+        return [node]
+
+
+class CustomTableCell(nodes.General, nodes.Element):
+    """A table cell (<td> or <th>)."""
+
+    @staticmethod
+    def visit_html(translator, node):
+        is_header = bool(node.get("header", False))
+        tag = "th" if is_header else "td"
+
+        classes = " ".join(node.get("classes", []))
+        colspan = node.get("colspan", 1)
+        rowspan = node.get("rowspan", 1)
+        show_when_attr = kv_to_data_attr("show-when", node.get("show-when", ""))
+
+        attrs = []
+        if classes:
+            attrs.append(f'class="{classes}"')
+        if colspan and colspan > 1:
+            attrs.append(f'colspan="{colspan}"')
+        if rowspan and rowspan > 1:
+            attrs.append(f'rowspan="{rowspan}"')
+        if show_when_attr:
+            attrs.append(show_when_attr)
+
+        attrs_str = "" if not attrs else " " + " ".join(attrs)
+        translator.body.append(f"<{tag}{attrs_str}>")
+
+    @staticmethod
+    def depart_html(translator, node):
+        tag = "th" if node.get("header", False) else "td"
+        translator.body.append(f"</{tag}>")
+
+
+class CustomTableCellDirective(SphinxDirective):
+    """.. matrix-cell::"""
+
+    required_arguments = 0
+    optional_arguments = 1
+    final_argument_whitespace = True
+    has_content = True
+    option_spec = {
+        "header": directives.flag,
+        "class": directives.class_option,
+        "colspan": directives.nonnegative_int,
+        "rowspan": directives.nonnegative_int,
+        "show-when": directives.unchanged,
+    }
+
+    def run(self):
+        label = self.arguments[0] if self.arguments else ""
+        node = CustomTableCell()
+
+        # Explicit :header: always wins
+        explicit_header = self.options.get("header", False) is not False
+
+        # Detect if the parent row (matrix-row) or one of its ancestors
+        # (matrix-head) marks this as a header section.
+        parent_header_row = False
+        parent_node = getattr(self.state, "parent", None)
+        if parent_node:
+            for ancestor in parent_node.traverse(include_self=True):
+                if isinstance(ancestor, CustomTableRow) and ancestor.get("header-row", False):
+                    parent_header_row = True
+                    break
+                if isinstance(ancestor, CustomTableHead):
+                    parent_header_row = True
+                    break
+        node["header"] = explicit_header or parent_header_row
+        node["classes"] = self.options.get("class", [])
+        node["colspan"] = self.options.get("colspan", 1)
+        node["rowspan"] = self.options.get("rowspan", 1)
+        node["show-when"] = self.options.get("show-when", "")
+
+        if self.content:
+            self.state.nested_parse(self.content, self.content_offset, node)
+        elif label:
+            node += nodes.Text(label)
+
+        # Sanity check nesting
+        if not parent_node or not any(
+            isinstance(p, CustomTableRow)
+            for p in parent_node.traverse(include_self=True)
+        ):
+            logger.warning(
+                "'.. matrix-cell::' at line %s should be nested under a '.. matrix-row::' directive",
+                self.lineno,
+                location=(self.env.docname, self.lineno),
+            )
+
+        return [node]
+
+
+def setup(app):
+    app.add_node(CustomTable, html=(CustomTable.visit_html, CustomTable.depart_html))
+    app.add_node(CustomTableHead, html=(CustomTableHead.visit_html, CustomTableHead.depart_html))
+    app.add_node(CustomTableRow, html=(CustomTableRow.visit_html, CustomTableRow.depart_html))
+    app.add_node(CustomTableCell, html=(CustomTableCell.visit_html, CustomTableCell.depart_html))
+
+    app.add_directive("matrix", CustomTableDirective)
+    app.add_directive("matrix-head", CustomTableHeadDirective)
+    app.add_directive("matrix-row", CustomTableRowDirective)
+    app.add_directive("matrix-cell", CustomTableCellDirective)
+
+    static_assets_dir = Path(__file__).parent / "static"
+    app.config.html_static_path.append(str(static_assets_dir))
+    app.add_css_file("table.css")
+
+    return {
+        "version": "1.1",
+        "parallel_read_safe": True,
+        "parallel_write_safe": True,
+    }
--- a/docs/extension/rocm_docs_custom/selector.py
+++ b/docs/extension/rocm_docs_custom/selector.py
@@ -1,20 +1,10 @@
 from sphinx.util.docutils import SphinxDirective, directives, nodes
 from pathlib import Path
-from .utils import kv_to_data_attr, normalize_key
-import random
-import string
-
+from .utils import kv_to_data_attr, normalize_key, logger

 class SelectorGroup(nodes.General, nodes.Element):
    """
-    A row within a selector container.
-
-    rST usage:
-
-    .. selector-group:: Heading
-       :key:
-       :show-when: os=ubuntu (list of key=value pairs separated by spaces)
-       :heading-width: 4 (defaults to 6)
+    A row or dropdown within a selector container.
    """

    @staticmethod
@@ -23,32 +13,46 @@ class SelectorGroup(nodes.General, nodes.Element):
        key = node["key"]
        show_when_attr = kv_to_data_attr("show-when", node["show-when"])
        heading_width = node["heading-width"]
-        icon = node["icon"]
+        list_mode = node.get("list", False)

-        icon_html = ""
-        if icon:
-            icon_html = f'<i class="rocm-docs-selector-icon {icon}"></i>'
+        # Standard tile mode
+        info_nodes = list(node.findall(SelectorInfo))
+        info_link = info_nodes[0]["link"] if info_nodes else None
+        info_icon = info_nodes[0]["icon"] if info_nodes else None
+
+        info_icon_html = ""
+        if info_link:
+            info_icon_html = f"""
+            <a href="{info_link}" target="_blank">
+                <i class="rocm-docs-selector-icon {info_icon}"></i>
+            </a>
+            """

        translator.body.append(
            "<!-- start selector-group row -->"
            f"""
-            <div id="{nodes.make_id(label)}" class="rocm-docs-selector-group row gx-0 pt-2"
+            <div id="{nodes.make_id(label)}"
+                class="rocm-docs-selector-group row gx-0 pt-2"
                data-selector-key="{key}"
                {show_when_attr}
-                role="radiogroup"
+                {'role="radiogroup"' if list_mode else ""}
                aria-label="{label}"
            >
                <div class="col-{heading_width} me-1 px-2 rocm-docs-selector-group-heading">
-                    <span class="rocm-docs-selector-group-heading-text">{label}{icon_html}</span>
+                    <span class="rocm-docs-selector-group-heading-text">{label}{info_icon_html}</span>
                </div>
                <div class="row col-{12 - heading_width} pe-0">
+                {f'<select class="form-select rocm-docs-selector-dropdown-list" aria-label="{label}">' if list_mode else ""}
            """.strip()
        )

    @staticmethod
-    def depart_html(translator, _):
+    def depart_html(translator, node):
+        list_mode = node.get("list", False)
+
        translator.body.append(
-            """
+            f"""
+                {"</select>" if list_mode else ""}
                </div>
            </div>
            """
@@ -57,14 +61,14 @@ class SelectorGroup(nodes.General, nodes.Element):


 class SelectorGroupDirective(SphinxDirective):
-    required_arguments = 1  # tile text
+    required_arguments = 1  # title text
    final_argument_whitespace = True
    has_content = True
    option_spec = {
        "key": directives.unchanged,
        "show-when": directives.unchanged,
        "heading-width": directives.nonnegative_int,
-        "icon": directives.unchanged,
+        "list": directives.flag,
    }

    def run(self):
@@ -74,73 +78,121 @@ class SelectorGroupDirective(SphinxDirective):
        node["key"] = normalize_key(self.options.get("key", label))
        node["show-when"] = self.options.get("show-when", "")
        node["heading-width"] = self.options.get("heading-width", 3)
-        node["icon"] = self.options.get("icon")
+        node["list"] = "list" in self.options

-        # Parse nested content
+        # Parse nested content (selector-info + selector-option)
        self.state.nested_parse(self.content, self.content_offset, node)

-        # Find all SelectorOption descendants
        option_nodes = list(node.findall(SelectorOption))
-
        if option_nodes:
-            # Set the group key on all options
            for opt in option_nodes:
                opt["group_key"] = node["key"]
+                opt["list"] = node["list"]

-            # Find all options marked as default
+            # Default marking
            default_options = [opt for opt in option_nodes if opt["default"]]
-
-            if default_options:
-                # Multiple options marked :default: - only keep first as default
-                for i, opt in enumerate(default_options):
-                    if i > 0:
-                        opt["default"] = False
-            else:
-                # No explicit default - make first option default
+            if not default_options:
                option_nodes[0]["default"] = True

        return [node]

+class SelectorInfo(nodes.General, nodes.Element):
+    """
+    Represents an informational icon/link associated with a selector group.
+    Appears as a clickable icon in the selector group heading.
+
+    rST usage:
+
+    .. selector:: AMD EPYC Server CPU
+       :key: cpu
+
+       .. selector-info:: https://www.amd.com/en/products/processors/server/epyc.html
+          :icon: fa-solid fa-circle-info fa-lg
+
+       .. selector-option:: EPYC 9005 (5th gen.)
+          :value: 9005
+    """
+
+    @staticmethod
+    def visit_html(translator, node):
+        # Do nothing — rendering handled by SelectorGroup
+        pass
+
+    @staticmethod
+    def depart_html(translator, node):
+        # Do nothing — prevent NotImplementedError
+        pass
+
+
+class SelectorInfoDirective(SphinxDirective):
+    required_arguments = 1  # link URL
+    final_argument_whitespace = True
+    has_content = False
+    option_spec = {"icon": directives.unchanged}
+
+    def run(self):
+        node = SelectorInfo()
+        node["link"] = self.arguments[0]
+        node["icon"] = self.options.get("icon", "fa-solid fa-circle-info fa-lg")
+
+        parent = getattr(self.state, "parent", None)
+        if not parent or not any(isinstance(p, SelectorGroup) for p in parent.traverse(include_self=True)):
+            logger.warning(
+                f"'.. selector-info::' at line {self.lineno} should be nested under a '.. selector::' directive",
+                location=(self.env.docname, self.lineno),
+            )
+
+        return [node]
+

 class SelectorOption(nodes.General, nodes.Element):
    """
-    A selectable tile within a selector group.
-
-    rST usage:
-
-    .. selector-option::
+    A selectable tile or list-item option within a selector group.
    """

    @staticmethod
    def visit_html(translator, node):
+        label = node["label"]
        value = node["value"]
+        show_when_attr = kv_to_data_attr("show-when", node["show-when"])
        disable_when_attr = kv_to_data_attr("disable-when", node["disable-when"])
        default = node["default"]
        width = node["width"]
-        group_key = node.get("group_key", "")
+        list_mode = node.get("list", False)
+
+        if list_mode:
+            selected_attr = " selected" if default else ""
+            translator.body.append(
+                f'<option value="{value}"{selected_attr} {show_when_attr} {disable_when_attr}>{label}</option>'
+            )
+            return

        default_class = "rocm-docs-selector-option-default" if default else ""
-
        translator.body.append(
            "<!-- start selector-option tile -->"
            f"""
            <div class="rocm-docs-selector-option {default_class} col-{width} px-2"
-                data-selector-key="{group_key}"
+                data-selector-key="{node.get('group_key', '')}"
                data-selector-value="{value}"
+                {show_when_attr}
                {disable_when_attr}
                tabindex="0"
                role="radio"
                aria-checked="false"
            >
+                <span>{label}</span>
            """.strip()
        )

    @staticmethod
    def depart_html(translator, node):
+        list_mode = node.get("list", False)
+        if list_mode:
+            return  # no closing tag needed for <option>
        icon = node["icon"]
        if icon:
            translator.body.append(f'<i class="rocm-docs-selector-icon {icon}"></i>')
-        translator.body.append("</div>" "<!-- end selector-option tile -->")
+        translator.body.append("</div><!-- end selector-option tile -->")


 class SelectorOptionDirective(SphinxDirective):
@@ -148,6 +200,7 @@ class SelectorOptionDirective(SphinxDirective):
    final_argument_whitespace = True
    option_spec = {
        "value": directives.unchanged,
+        "show-when": directives.unchanged,
        "disable-when": directives.unchanged,
        "default": directives.flag,
        "width": directives.nonnegative_int,
@@ -160,22 +213,31 @@ class SelectorOptionDirective(SphinxDirective):
        node = SelectorOption()
        node["label"] = label
        node["value"] = normalize_key(self.options.get("value", label))
-        # node["show-when"] = self.options.get("show-when", "")
+        node["show-when"] = self.options.get("show-when", "")
        node["disable-when"] = self.options.get("disable-when", "")
        node["default"] = self.options.get("default", False) is not False
        node["width"] = self.options.get("width", 6)
        node["icon"] = self.options.get("icon")

        # Content replaces label if provided
-        if self.content:
-            self.state.nested_parse(self.content, self.content_offset, node)
-        else:
-            node += nodes.Text(label)
+        # if self.content:
+        #     self.state.nested_parse(self.content, self.content_offset, node)
+        # else:
+        #     node += nodes.Text(label)
+
+        parent = getattr(self.state, "parent", None)
+        if not parent or not any(isinstance(p, SelectorGroup) for p in parent.traverse(include_self=True)):
+            logger.warning(
+                f"'.. selector-option::' at line {self.lineno} should be nested under a '.. selector::' directive",
+                location=(self.env.docname, self.lineno),
+            )
+
        return [node]

+
 class SelectedContent(nodes.General, nodes.Element):
    """
-    A container to hold conditional content.
+    A container to hold documentation content to be shown conditionally.

    rST usage::

@@ -185,20 +247,21 @@ class SelectedContent(nodes.General, nodes.Element):

    @staticmethod
    def visit_html(translator, node):
-        show_when_attr = kv_to_data_attr("show-when", node["show-when"])
+        show_when = node.get("show-when", "")
+        show_when_attr = kv_to_data_attr("show-when", show_when)
        classes = " ".join(node.get("class", []))
        heading = node.get("heading", "")
-        heading_level = node.get("heading-level") or (SelectedContent._get_depth(node) + 1)
-        heading_level = min(heading_level, 6)
+        # default to <h2>
+        heading_level = min(node.get("heading-level") or 2, 6) # maximum depth is <h6>

+        id_attr = ""
        heading_elem = ""
+        combined_show_when = node.get("combined-show-when", show_when)
        if heading:
-            # HACK to fix secondary sidebar observer
-            suffix = "".join(random.choices(string.ascii_lowercase + string.digits, k=3))
-            id_attr = nodes.make_id(f"{heading}-{suffix}")
+            id_attr = nodes.make_id(f"{heading}-{combined_show_when}")

            heading_elem = (
-                f'<h{heading_level} id="{id_attr}" class="rocm-docs-custom-heading">'
+                f'<h{heading_level} class="rocm-docs-custom-heading">'
                f'{heading}<a class="headerlink" href="#{id_attr}" title="Link to this heading">#</a>'
                f'</h{heading_level}>'
            )
@@ -206,24 +269,22 @@ class SelectedContent(nodes.General, nodes.Element):
        translator.body.append(
            f"""
            <!-- start selected-content -->
-            <div class="rocm-docs-selected-content {classes}" {show_when_attr} aria-hidden="true">
+            <{"section" if heading else "div"}
+                id="{id_attr}"
+                class="rocm-docs-selected-content {classes}"
+                {show_when_attr}
+                aria-hidden="true">
                {heading_elem}
            """.strip()
        )

    @staticmethod
-    def depart_html(translator, _):
-        translator.body.append("</div><!-- end selected-content -->")
+    def depart_html(translator, node):
+        heading = node.get("heading", "")

-    @staticmethod
-    def _get_depth(node):
-        depth = 1
-        parent = node.parent
-        while parent is not None:
-            if isinstance(parent, SelectedContent) and parent.get("heading"):
-                depth += 1
-            parent = getattr(parent, "parent", None)
-        return depth
+        translator.body.append(f"""
+            </{"section" if heading else "div"}>
+            <!-- end selected-content -->""")


 class SelectedContentDirective(SphinxDirective):
@@ -242,9 +303,20 @@ class SelectedContentDirective(SphinxDirective):
        node["show-when"] = self.arguments[0]
        node["id"] = self.options.get("id", "")
        node["class"] = self.options.get("class", "")
-        node["heading"] = self.options.get("heading", "")  # empty string if none
+        node["heading"] = self.options.get("heading", "")
        node["heading-level"] = self.options.get("heading-level", None)

+        # Collect parent show-whens (if nested)
+        # to create a completely unique id
+        parent_show_whens = []
+        for ancestor in self.state.parent.traverse(include_self=True):
+            if isinstance(ancestor, SelectedContent) and "show-when" in ancestor:
+                parent_show_whens.append(ancestor["show-when"])
+
+        # Compose combined show-when chain
+        combined_show_when = "+".join(parent_show_whens + [node["show-when"]])
+        node["combined-show-when"] = combined_show_when
+
        # Parse nested content
        self.state.nested_parse(self.content, self.content_offset, node)
        return [node]
@@ -255,6 +327,10 @@ def setup(app):
        SelectorGroup,
        html=(SelectorGroup.visit_html, SelectorGroup.depart_html),
    )
+    app.add_node(
+        SelectorInfo,
+        html=(SelectorInfo.visit_html, SelectorInfo.depart_html),
+    )
    app.add_node(
        SelectorOption,
        html=(SelectorOption.visit_html, SelectorOption.depart_html),
@@ -265,13 +341,14 @@ def setup(app):
    )

    app.add_directive("selector", SelectorGroupDirective)
+    app.add_directive("selector-info", SelectorInfoDirective)
    app.add_directive("selector-option", SelectorOptionDirective)
    app.add_directive("selected-content", SelectedContentDirective)
    app.add_directive("selected", SelectedContentDirective)

-    static_assets_dir = Path(__file__).parent / "static"
+    static_assets_dir = Path(__file__).parent / "static" / "selector"
    app.config.html_static_path.append(str(static_assets_dir))
    app.add_css_file("selector.css")
    app.add_js_file("selector.js", type="module", defer="defer")

-    return {"version": "1.0", "parallel_read_safe": True}
+    return {"version": "1.1", "parallel_read_safe": True}
--- a/docs/extension/rocm_docs_custom/static/selector.js
+++ b/docs/extension/rocm_docs_custom/static/selector.js
@@ -1,300 +0,0 @@
-const READY_EVENT = "ROCmDocsSelectorsReady";
-const STATE_CHANGE_EVENT = "ROCmDocsSelectorStateChanged";
-
-const GROUP_QUERY = ".rocm-docs-selector-group";
-const OPTION_QUERY = ".rocm-docs-selector-option";
-const COND_QUERY = "[data-show-when]";
-const TOC2_OPTIONS_LIST_QUERY = ".rocm-docs-selector-toc2-options";
-const TOC2_CONTENTS_LIST_QUERY = ".rocm-docs-selector-toc2-contents";
-const HEADING_QUERY = ".rocm-docs-selected-content h1,h2,h3,h4,h5,h6[id]";
-
-const isDefaultOption = (elem) =>
-  elem.classList.contains("rocm-docs-selector-option-default");
-
-const DISABLED_CLASS = "rocm-docs-disabled";
-const disable = (elem) => {
-  elem.classList.add(DISABLED_CLASS);
-  elem.setAttribute("aria-disabled", "true");
-  elem.setAttribute("tabindex", "-1");
-};
-// const enable = (elem) => {
-//   elem.classList.remove(DISABLED_CLASS);
-//   elem.setAttribute("aria-disabled", "false");
-//   elem.setAttribute("tabindex", "0");
-// };
-
-const HIDDEN_CLASS = "rocm-docs-hidden";
-const hide = (elem) => {
-  elem.classList.add(HIDDEN_CLASS);
-  elem.setAttribute("aria-hidden", "true");
-};
-const show = (elem) => {
-  elem.classList.remove(HIDDEN_CLASS);
-  elem.setAttribute("aria-hidden", "false");
-};
-
-const SELECTED_CLASS = "rocm-docs-selected";
-const select = (elem) => {
-  elem.classList.add(SELECTED_CLASS);
-  elem.setAttribute("aria-checked", "true");
-};
-const deselect = (elem) => {
-  elem.classList.remove(SELECTED_CLASS);
-  elem.setAttribute("aria-checked", "false");
-};
-
-const state = {};
-
-function getState() {
-  return { ...state };
-}
-
-function setState(updates) {
-  const previousState = getState();
-  Object.assign(state, updates);
-
-  const event = new CustomEvent(STATE_CHANGE_EVENT, {
-    detail: {
-      previousState,
-      currentState: getState(),
-      changes: updates,
-    },
-  });
-  document.dispatchEvent(event);
-}
-
-function validateOptionElem(optionElem) {
-  const key = optionElem.dataset.selectorKey;
-  const value = optionElem.dataset.selectorValue;
-
-  const errors = [];
-  if (!key) errors.push("Missing 'data-selector-key'");
-  if (!value) errors.push("Missing 'data-selector-value'");
-
-  if (errors.length === 0) return;
-
-  const label = optionElem.textContent.trim() || "<unnamed option>";
-  console.error(
-    `[ROCmDocsSelector] Invalid selector option '${label}': ${
-      errors.join(", ")
-    }!`,
-  );
-  disable(optionElem);
-}
-
-function handleOptionSelect(e) {
-  const option = e.currentTarget;
-  const parentGroup = option.closest(GROUP_QUERY);
-  const siblingOptions = parentGroup.querySelectorAll(OPTION_QUERY);
-
-  siblingOptions.forEach((elem) => deselect(elem));
-  select(option);
-
-  // Update global state
-  const key = option.dataset.selectorKey;
-  const value = option.dataset.selectorValue;
-  if (key && value) setState({ [key]: value });
-
-  updateVisibility();
-}
-
-function shouldBeShown(elem) {
-  const conditionsData = elem.dataset.showWhen;
-  if (!conditionsData) return true; // Default visible
-
-  try {
-    const conditions = JSON.parse(conditionsData);
-    // Ensure it's an object
-    if (typeof conditions !== "object" || Array.isArray(conditions)) {
-      console.warn(
-        "[ROCmDocsSelector] Invalid 'show-when' format (must be key/value object):",
-        conditionsData,
-      );
-      return true;
-    }
-
-    for (const [key, value] of Object.entries(conditions)) {
-      const currentValue = state[key];
-
-      if (currentValue === undefined) return false;
-
-      if (Array.isArray(value)) {
-        if (!value.includes(currentValue)) return false;
-        continue;
-      }
-
-      if (state[key] !== value) {
-        return false;
-      }
-    }
-
-    return true;
-  } catch (err) {
-    console.error(
-      "[ROCmDocsSelector] Couldn't parse 'show-when' conditions:",
-      err,
-    );
-    return true;
-  }
-}
-
-function updateTOC2OptionsList() {
-  const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
-  if (!tocOptionsList) return;
-
-  // Clear previous entries
-  tocOptionsList.innerHTML = "";
-
-  // Get only visible selector groups
-  const groups = Array.from(document.querySelectorAll(GROUP_QUERY)).filter(
-    (g) => g.offsetParent !== null
-  );
-
-  if (groups.length === 0) {
-    const li = document.createElement("li");
-    li.className =
-      "nav-item toc-entry toc-h3 rocm-docs-selector-toc2-item empty";
-    const span = document.createElement("span");
-    span.textContent = "(no visible selectors)";
-    li.appendChild(span);
-    tocOptionsList.appendChild(li);
-    return;
-  }
-
-  groups.forEach((group) => {
-    // ✅ Find group heading span
-    const headingSpan = group.querySelector(
-      ".rocm-docs-selector-group-heading-text"
-    );
-    const headingText = headingSpan
-      ? headingSpan.textContent.trim()
-      : "(Unnamed Selector)";
-
-    // Find currently selected option
-    const selectedOption = group.querySelector(`.${SELECTED_CLASS}`);
-    const optionText = selectedOption
-      ? selectedOption.textContent.trim()
-      : "(none selected)";
-
-    // Build list item
-    const li = document.createElement("li");
-    li.className = "nav-item toc-entry toc-h3 rocm-docs-selector-toc2-item";
-
-    const link = document.createElement("a");
-    link.className = "nav-link";
-    link.href = `#${group.id}`;
-    link.innerHTML = `<strong>${headingText}</strong>: ${optionText}`;
-
-    li.appendChild(link);
-    tocOptionsList.appendChild(li);
-  });
-}
-
-function updateTOC2ContentsList() {
-  const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
-  const tocContentsList = document.querySelector(TOC2_CONTENTS_LIST_QUERY);
-  if (!tocContentsList || !tocOptionsList) return;
-
-  const visibleHeaders = [...document.querySelectorAll(HEADING_QUERY)]
-    .filter((h) => h.offsetParent !== null); // only visible headings
-
-  tocContentsList
-    .querySelectorAll("li.toc-entry.rocm-docs-selector-toc2-item")
-    .forEach((node) => node.remove());
-
-  if (visibleHeaders.length === 0) return;
-
-  let lastH2Li = null;
-
-  visibleHeaders.forEach((h) => {
-    const level = parseInt(h.tagName.substring(1), 10);
-    const li = document.createElement("li");
-    li.className = `nav-item toc-entry toc-${h.tagName.toLowerCase()} rocm-docs-selector-toc2-item`;
-
-    const a = document.createElement("a");
-    a.className = "reference internal nav-link";
-    const section = h.closest("section");
-    const fallbackId = section ? section.id : "";
-    a.href = h.id ? `#${h.id}` : fallbackId ? `#${fallbackId}` : "#";
-    a.textContent = h.cloneNode(true).childNodes[0].textContent.trim();
-    li.appendChild(a);
-
-    // Nest logic: h3+ belong to last h2's inner list
-    if (level === 2) {
-      tocContentsList.appendChild(li);
-      lastH2Li = li;
-    } else if (level === 3 && lastH2Li) {
-      // ensure nested UL exists
-      let innerUl = lastH2Li.querySelector("ul");
-      if (!innerUl) {
-        innerUl = document.createElement("ul");
-        innerUl.className = "nav section-nav flex-column";
-        lastH2Li.appendChild(innerUl);
-      }
-      innerUl.appendChild(li);
-    } else {
-      tocContentsList.appendChild(li);
-    }
-  });
-}
-
-function updateVisibility() {
-  document.querySelectorAll(COND_QUERY).forEach((elem) => {
-    if (shouldBeShown(elem)) {
-      show(elem);
-    } else {
-      hide(elem);
-    }
-  });
-
-  updateTOC2OptionsList();
-  updateTOC2ContentsList();
-}
-
-function init() {
-  const selectorOptions = document.querySelectorAll(OPTION_QUERY);
-
-  const initialState = {};
-
-  // Attach listeners and gather defaults
-  selectorOptions.forEach((option) => {
-    validateOptionElem(option);
-
-    option.addEventListener("click", handleOptionSelect);
-    option.addEventListener("keydown", (e) => {
-      if (e.key === "Enter" || e.key === " ") {
-        e.preventDefault();
-        handleOptionSelect(e);
-      }
-    });
-
-    if (isDefaultOption(option)) {
-      select(option);
-      const { selectorKey: key, selectorValue: value } = option.dataset;
-      if (key && value) {
-        initialState[key] = value;
-      }
-    }
-  });
-
-  setState(initialState);
-  updateVisibility();
-
-  document.dispatchEvent(new CustomEvent(READY_EVENT));
-}
-
-function domReady(callback) {
-  if (document.readyState !== "loading") {
-    callback();
-  } else {
-    document.addEventListener("DOMContentLoaded", callback, { once: true });
-  }
-}
-
-// window.rocmDocsSelector = {
-//   setState,
-//   getState,
-// };
-
-// Initialize when DOM is ready
-domReady(init);
--- a/docs/extension/rocm_docs_custom/static/selector/selector-toc.js
+++ b/docs/extension/rocm_docs_custom/static/selector/selector-toc.js
@@ -0,0 +1,235 @@
+const GROUP_QUERY = ".rocm-docs-selector-group";
+const SELECTED_CLASS = "rocm-docs-selected";
+const TOC2_OPTIONS_LIST_QUERY = ".rocm-docs-selector-toc2-options";
+const TOC2_CONTENTS_LIST_QUERY = ".rocm-docs-selector-toc2-contents";
+const HEADING_QUERY = ".rocm-docs-selected-content h1,h2,h3,h4,h5,h6";
+
+const TOC_ITEM_CLASS = "rocm-docs-selector-toc2-item";
+const EMPTY_ITEM_CLASS = "empty";
+
+let optionsTocInitialized = false;
+
+function isVisible(el) {
+  return !!(el && el.offsetParent !== null);
+}
+
+function getUniqueGroups(groups) {
+  const seen = new Set();
+  return groups.filter((group) => {
+    // Use group ID as primary identity; fallback to heading text
+    const headingSpan = group.querySelector(
+      ".rocm-docs-selector-group-heading-text"
+    );
+    const headingText = headingSpan
+      ? headingSpan.textContent.trim()
+      : "(Unnamed Selector)";
+    const identifier = group.id ? `id:${group.id}` : `heading:${headingText}`;
+
+    if (seen.has(identifier)) return false;
+    seen.add(identifier);
+    return true;
+  });
+}
+
+function initTOC2OptionsList() {
+  const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
+  if (!tocOptionsList) return;
+
+  tocOptionsList.innerHTML = "";
+
+  let groups = Array.from(document.querySelectorAll(GROUP_QUERY)).filter(isVisible);
+  groups = getUniqueGroups(groups);
+
+  if (groups.length === 0) {
+    const li = document.createElement("li");
+    li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS} ${EMPTY_ITEM_CLASS}`;
+    const span = document.createElement("span");
+    span.textContent = "(no visible selectors)";
+    li.appendChild(span);
+    tocOptionsList.appendChild(li);
+    optionsTocInitialized = true;
+    return;
+  }
+
+  groups.forEach((group) => {
+    const headingSpan = group.querySelector(
+      ".rocm-docs-selector-group-heading-text"
+    );
+    const headingText = headingSpan
+      ? headingSpan.textContent.trim()
+      : "(Unnamed Selector)";
+
+    const li = document.createElement("li");
+    li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS}`;
+    li.dataset.groupId = group.id || "";
+
+    const link = document.createElement("a");
+    link.className = "nav-link";
+    link.href = group.id ? `#${group.id}` : "#";
+    link.dataset.headingText = headingText;
+
+    const selectedOption = group.querySelector(`.${SELECTED_CLASS}`);
+    let optionText = "(none selected)";
+    if (selectedOption) {
+      const clone = selectedOption.cloneNode(true);
+      clone.querySelectorAll("i, svg").forEach((el) => el.remove());
+      optionText = clone.innerHTML.trim();
+    }
+
+    link.innerHTML = `<strong>${headingText}</strong>: ${optionText}`;
+    li.appendChild(link);
+    tocOptionsList.appendChild(li);
+  });
+
+  optionsTocInitialized = true;
+}
+
+export function updateTOC2OptionsList() {
+  const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
+  if (!tocOptionsList) return;
+
+  let visibleGroups = Array.from(document.querySelectorAll(GROUP_QUERY)).filter(
+    isVisible
+  );
+  visibleGroups = getUniqueGroups(visibleGroups);
+
+  // Always rebuild fresh (simpler, avoids state drift)
+  tocOptionsList.innerHTML = "";
+
+  if (visibleGroups.length === 0) {
+    const li = document.createElement("li");
+    li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS} ${EMPTY_ITEM_CLASS}`;
+    const span = document.createElement("span");
+    span.textContent = "(no visible selectors)";
+    li.appendChild(span);
+    tocOptionsList.appendChild(li);
+    return;
+  }
+
+  visibleGroups.forEach((group) => {
+    const headingSpan = group.querySelector(
+      ".rocm-docs-selector-group-heading-text"
+    );
+    const headingText = headingSpan
+      ? headingSpan.textContent.trim()
+      : "(Unnamed Selector)";
+
+    const li = document.createElement("li");
+    li.className = `nav-item toc-entry toc-h3 ${TOC_ITEM_CLASS}`;
+    li.dataset.groupId = group.id || "";
+
+    const link = document.createElement("a");
+    link.className = "nav-link";
+    link.href = group.id ? `#${group.id}` : "#";
+    link.dataset.headingText = headingText;
+
+    const selectedOption = group.querySelector(`.${SELECTED_CLASS}`);
+    let optionText = "(none selected)";
+    if (selectedOption) {
+      const clone = selectedOption.cloneNode(true);
+      clone.querySelectorAll("i, svg").forEach((el) => el.remove());
+      optionText = clone.innerHTML.trim();
+    }
+
+    link.innerHTML = `<strong>${headingText}</strong>: ${optionText}`;
+    li.appendChild(link);
+    tocOptionsList.appendChild(li);
+  });
+}
+
+let contentsTocInitialized = false;
+
+function initTOC2ContentsList() {
+  const tocContentsList = document.querySelector(TOC2_CONTENTS_LIST_QUERY);
+  if (!tocContentsList) return;
+
+  // Remove any previous dynamic items (idempotent init)
+  tocContentsList
+    .querySelectorAll(`li.toc-entry.${TOC_ITEM_CLASS}`)
+    .forEach((node) => node.remove());
+
+  const headings = Array.from(document.querySelectorAll(HEADING_QUERY));
+  if (headings.length === 0) {
+    contentsTocInitialized = true;
+    return;
+  }
+
+  const lastLiByLevel = {};
+
+  headings.forEach((h) => {
+    const level = parseInt(h.tagName.substring(1), 10);
+    if (Number.isNaN(level) || level < 2 || level > 6) return;
+
+    const li = document.createElement("li");
+    li.className = `nav-item toc-entry toc-${h.tagName.toLowerCase()} ` +
+      TOC_ITEM_CLASS;
+
+    const a = document.createElement("a");
+    a.className = "reference internal nav-link";
+
+    const section = h.closest("section");
+    const targetId = h.id || (section ? section.id : "");
+    a.href = targetId ? `#${targetId}` : "#";
+
+    // Use only the text from the heading (ignore headerlink icon etc.)
+    const clone = h.cloneNode(true);
+    const firstTextNode = clone.childNodes.length > 0
+      ? clone.childNodes[0].textContent
+      : "";
+    a.textContent = (firstTextNode || "").trim();
+
+    li.dataset.targetId = targetId;
+    li.appendChild(a);
+
+    // Nest under closest previous shallower heading
+    let parentUl = null;
+    for (let parentLevel = level - 1; parentLevel >= 2; parentLevel -= 1) {
+      const parentLi = lastLiByLevel[parentLevel];
+      if (parentLi) {
+        parentUl = parentLi.querySelector("ul");
+        if (!parentUl) {
+          parentUl = document.createElement("ul");
+          parentUl.className = "nav section-nav flex-column";
+          parentLi.appendChild(parentUl);
+        }
+        break;
+      }
+    }
+
+    if (parentUl) {
+      parentUl.appendChild(li);
+    } else {
+      tocContentsList.appendChild(li);
+    }
+
+    lastLiByLevel[level] = li;
+    for (let deeper = level + 1; deeper <= 6; deeper += 1) {
+      delete lastLiByLevel[deeper];
+    }
+  });
+
+  contentsTocInitialized = true;
+}
+
+export function updateTOC2ContentsList() {
+  const tocOptionsList = document.querySelector(TOC2_OPTIONS_LIST_QUERY);
+  const tocContentsList = document.querySelector(TOC2_CONTENTS_LIST_QUERY);
+  if (!tocContentsList || !tocOptionsList) return;
+
+  if (!contentsTocInitialized) {
+    initTOC2ContentsList();
+  }
+
+  tocContentsList
+    .querySelectorAll(`li.toc-entry.${TOC_ITEM_CLASS}`)
+    .forEach((li) => {
+      const targetId = li.dataset.targetId;
+      if (!targetId) {
+        li.style.display = "none";
+        return;
+      }
+      const target = document.getElementById(targetId);
+      const visible = target && target.offsetParent !== null;
+      li.style.display = visible ? "" : "none";
+    });
+}
--- a/docs/extension/rocm_docs_custom/static/selector/selector.css
+++ b/docs/extension/rocm_docs_custom/static/selector/selector.css
@@ -7,6 +7,11 @@ html {
  --rocm-docs-selector-option-hover-color: var(--pst-color-link-hover);
  --rocm-docs-selector-option-selected-color: var(--pst-color-primary);
  --rocm-docs-selector-tile-padding: 0.2rem;
+  --rocm-docs-selector-tile-gap: 0.5rem;
+  --rocm-docs-selector-focus-ring: 2px solid var(
+    --rocm-docs-selector-accent-color
+  );
+  --rocm-docs-selector-focus-offset: 2px;
 }

 html[data-theme="light"] {
@@ -21,15 +26,37 @@ html[data-theme="dark"] {
  --rocm-docs-selector-shadow-hover: 0 2px 8px rgba(0, 0, 0, 0.4);
 }

-/* Selector container */
-.rocm-docs-selector-container {
-  padding: 0 0 1rem 0;
+/* Avoid odd sizing interactions with Bootstrap width utilities */
+.rocm-docs-selector-group,
+.rocm-docs-selector-group * {
+  box-sizing: border-box;
 }

-/* Selector group heading when one of its options is hovered */
-.rocm-docs-selector-group:has(.rocm-docs-selector-option:hover)
-  .rocm-docs-selector-group-heading {
-  border-right-color: var(--rocm-docs-selector-option-hover-color);
+/* Hide selectors during initialization to prevent FOUC */
+.rocm-docs-selector-group:not(.rocm-docs-selector-initialized) {
+  visibility: hidden;
+}
+
+/* Smooth fade-in when ready */
+.rocm-docs-selector-group.rocm-docs-selector-initialized {
+  visibility: visible;
+  animation: rocm-docs-selector-fade-in 0.2s ease-in;
+}
+
+@keyframes rocm-docs-selector-fade-in {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@supports selector(.x:has(.y)) {
+  .rocm-docs-selector-group:has(.rocm-docs-selector-option:hover)
+    .rocm-docs-selector-group-heading {
+    border-right-color: var(--rocm-docs-selector-option-hover-color);
+  }
 }

 /* Selector group heading box */
@@ -39,7 +66,7 @@ html[data-theme="dark"] {
  font-weight: 600;
  border-right: solid 3px var(--rocm-docs-selector-accent-color);
  border-radius: var(--rocm-docs-selector-border-radius);
-  transition: border-right-color 0.25s ease;
+  transition: border-color 0.25s ease;
  box-shadow: var(--rocm-docs-selector-shadow);
 }

@@ -57,16 +84,25 @@ html[data-theme="dark"] {
  justify-content: space-between;
  align-items: center;
  gap: 0.5rem;
+
  background-color: var(--rocm-docs-selector-bg-color);
  padding: var(--rocm-docs-selector-tile-padding);
  border: solid 2px var(--rocm-docs-selector-border-color);
-  cursor: pointer;
-  transition: all 0.2 ease;
  border-radius: var(--rocm-docs-selector-border-radius);
  box-shadow: var(--rocm-docs-selector-shadow);
+
+  cursor: pointer;
+  user-select: none;
+
+  transition:
+    background-color 0.2s ease,
+    color 0.2s ease,
+    transform 0.2s ease,
+    box-shadow 0.2s ease,
+    border-color 0.2s ease;
 }

-/* Selector option when hovered */
+/* Hover (not disabled) */
 .rocm-docs-selector-option:hover:not(.rocm-docs-disabled) {
  background-color: var(--rocm-docs-selector-option-hover-color);
  color: var(--rocm-docs-selector-fg-color);
@@ -74,30 +110,94 @@ html[data-theme="dark"] {
  box-shadow: var(--rocm-docs-selector-shadow-hover);
 }

-.rocm-docs-selector-option:focus:not(.rocm-docs-disabled) {
-  z-index: 69;
+/* Accessible keyboard focus */
+.rocm-docs-selector-option:focus-visible:not(.rocm-docs-disabled) {
+  outline: var(--rocm-docs-selector-focus-ring);
+  outline-offset: var(--rocm-docs-selector-focus-offset);
 }

-/* Selector option when selected */
+/* Keep it above neighbors if it gets an outline/box-shadow */
+.rocm-docs-selector-option:focus:not(.rocm-docs-disabled) {
+  position: relative;
+  z-index: 1;
+}
+
+/* Selected */
 .rocm-docs-selector-option.rocm-docs-selected {
  background-color: var(--rocm-docs-selector-option-selected-color);
  color: var(--rocm-docs-selector-fg-color);
 }

-/* Prevent hover effect on selected */
+/* Prevent hover lift on selected (keeps it steady) */
 .rocm-docs-selector-option.rocm-docs-selected:hover {
  transform: none;
 }

-/* Selector option when disabled */
+/* Disabled */
 .rocm-docs-selector-option.rocm-docs-disabled {
  background-color: var(--rocm-docs-selector-border-color);
  color: var(--rocm-docs-selector-fg-color);
  cursor: not-allowed;
  pointer-events: none;
+  opacity: 0.75;
 }

 /* Hidden state */
 .rocm-docs-hidden {
  display: none;
 }
+
+/* Put selected option summary in secondary page-level TOC on a new line */
+.rocm-docs-selector-toc2-item .nav-link span {
+  display: block;
+  padding-left: 1rem;
+}
+
+@media (max-width: 768px) {
+  .rocm-docs-selector-group {
+    row-gap: var(--rocm-docs-selector-tile-gap);
+  }
+}
+
+@media (max-width: 576px) {
+  .rocm-docs-selector-option {
+    flex: 0 0 100%;
+    max-width: 100%;
+  }
+}
+
+@media (max-width: 440px) {
+  .rocm-docs-selector-group-heading {
+    flex: 0 0 100%;
+    max-width: 100%;
+
+    /* When stacked, puth the accent on the bottom */
+    border-right: 0;
+    border-bottom: solid 3px var(--rocm-docs-selector-accent-color);
+  }
+
+  .rocm-docs-selector-group.row .row {
+    flex: 0 0 100%;
+    max-width: 100%;
+  }
+
+  .rocm-docs-selector-option {
+    flex: 0 0 100%;
+    max-width: 100%;
+  }
+}
+
+/* Motion reduction */
+@media (prefers-reduced-motion: reduce) {
+  .rocm-docs-selector-group.rocm-docs-selector-initialized {
+    animation: none;
+  }
+
+  .rocm-docs-selector-option {
+    transition: none;
+  }
+
+  .rocm-docs-selector-option:hover:not(.rocm-docs-disabled) {
+    transform: none;
+  }
+}
--- a/docs/extension/rocm_docs_custom/static/selector/selector.js
+++ b/docs/extension/rocm_docs_custom/static/selector/selector.js
@@ -0,0 +1,329 @@
+import { domReady, logDebug } from "./utils.js";
+import {
+  updateTOC2ContentsList,
+  updateTOC2OptionsList,
+} from "./selector-toc.js";
+
+const GROUP_QUERY = ".rocm-docs-selector-group";
+const OPTION_QUERY = ".rocm-docs-selector-option";
+const COND_QUERY = "[data-show-when],[data-disable-when]";
+
+const DEFAULT_OPTION_CLASS = "rocm-docs-selector-option-default";
+const DISABLED_CLASS = "rocm-docs-disabled";
+const HIDDEN_CLASS = "rocm-docs-hidden";
+const SELECTED_CLASS = "rocm-docs-selected";
+
+// Toggle helpers -------------------------------------------------------------
+
+const isDefaultOption = (elem) => elem.classList.contains(DEFAULT_OPTION_CLASS);
+
+const disable = (elem) => {
+  elem.classList.add(DISABLED_CLASS);
+  elem.setAttribute("aria-disabled", "true");
+  elem.setAttribute("tabindex", "-1");
+};
+
+const enable = (elem) => {
+  elem.classList.remove(DISABLED_CLASS);
+  elem.setAttribute("aria-disabled", "false");
+  elem.setAttribute("tabindex", "0");
+};
+
+const hide = (elem) => {
+  elem.classList.add(HIDDEN_CLASS);
+  elem.setAttribute("aria-hidden", "true");
+};
+
+const show = (elem) => {
+  elem.classList.remove(HIDDEN_CLASS);
+  elem.setAttribute("aria-hidden", "false");
+};
+
+const select = (elem) => {
+  elem.classList.add(SELECTED_CLASS);
+  elem.setAttribute("aria-checked", "true");
+};
+
+const deselect = (elem) => {
+  elem.classList.remove(SELECTED_CLASS);
+  elem.setAttribute("aria-checked", "false");
+};
+
+// Global selector state ------------------------------------------------------
+
+const state = {};
+
+function getState() {
+  return { ...state };
+}
+
+function setState(updates) {
+  Object.assign(state, updates);
+  logDebug("State updated:", state);
+}
+
+// Condition handling ---------------------------------------------------------
+
+/**
+ * Safely parse JSON-encoded conditions from a data-* attribute.
+ * Expects a key/value object, where values may be strings or arrays of strings.
+ */
+function parseConditions(attrName, raw) {
+  if (!raw) return null;
+
+  try {
+    const conditions = JSON.parse(raw);
+    if (typeof conditions !== "object" || Array.isArray(conditions)) {
+      console.warn(
+        `[ROCmDocsSelector] Invalid '${attrName}' format ` +
+          "(must be a key/value object):",
+        raw,
+      );
+      return null;
+    }
+    return conditions;
+  } catch (err) {
+    console.error(
+      `[ROCmDocsSelector] Couldn't parse '${attrName}' conditions:`,
+      err,
+    );
+    return null;
+  }
+}
+
+/**
+ * Return true iff all conditions match the current state.
+ * - Values can be a string or an array of strings.
+ * - A condition with an undefined state key is treated as not matching.
+ */
+function matchesConditions(conditions, currentState) {
+  for (const [key, expected] of Object.entries(conditions)) {
+    const actual = currentState[key];
+
+    // If no value yet, this condition does not match.
+    if (actual === undefined) return false;
+
+    if (Array.isArray(expected)) {
+      if (!expected.includes(actual)) return false;
+    } else if (actual !== expected) {
+      return false;
+    }
+  }
+  return true;
+}
+
+function shouldBeDisabled(elem) {
+  const raw = elem.dataset.disableWhen;
+  if (!raw) return false; // no conditions => never disabled
+
+  const conditions = parseConditions("disable-when", raw);
+  if (!conditions) {
+    console.warn(
+      "[ROCmDocsSelector] Invalid 'show-when' conditions; " +
+        "hiding affected element.",
+    );
+    return false;
+  }
+
+  return matchesConditions(conditions, state);
+}
+
+function shouldBeShown(elem) {
+  const raw = elem.dataset.showWhen;
+  if (!raw) return true; // no conditions => always visible
+
+  const conditions = parseConditions("show-when", raw);
+  if (!conditions) return true;
+
+  return matchesConditions(conditions, state);
+}
+
+// Event handlers -------------------------------------------------------------
+
+function handleOptionSelect(e) {
+  const option = e.currentTarget;
+
+  // Ignore interaction with disabled or already selected options
+  if (
+    option.classList.contains(DISABLED_CLASS) ||
+    option.classList.contains(SELECTED_CLASS)
+  ) {
+    return;
+  }
+
+  const { selectorKey: key, selectorValue: value } = option.dataset;
+  if (!key || !value) return;
+
+  // Update all selectors sharing the same key
+  const allOptions = document.querySelectorAll(
+    `${OPTION_QUERY}[data-selector-key="${key}"]`,
+  );
+
+  allOptions.forEach((opt) => {
+    if (opt.dataset.selectorValue === value) {
+      select(opt);
+    } else {
+      deselect(opt);
+    }
+  });
+
+  // Update global state
+  setState({ [key]: value });
+
+  // Re-run visibility rules and TOC sync
+  updateVisibility();
+}
+
+function handleOptionKeydown(e) {
+  if (e.key === "Enter" || e.key === " ") {
+    e.preventDefault();
+    handleOptionSelect(e);
+  }
+}
+
+// Visibility / enablement update --------------------------------------------
+
+// Ensure each selector group always has a valid selected option.
+// If the current selection becomes disabled/hidden due to another selector's
+// change, automatically pick a replacement.
+function reconcileGroupSelections() {
+  const currentState = getState();
+  const updates = {};
+
+  document.querySelectorAll(GROUP_QUERY).forEach((group) => {
+    // Skip groups that are themselves hidden
+    if (group.classList.contains(HIDDEN_CLASS)) return;
+
+    const options = Array.from(group.querySelectorAll(OPTION_QUERY));
+    if (!options.length) return;
+
+    const groupKey = group.dataset.selectorKey ||
+      options[0].dataset.selectorKey;
+    if (!groupKey) return;
+
+    // Options that are both enabled and visible
+    const enabledVisible = options.filter(
+      (opt) =>
+        !opt.classList.contains(DISABLED_CLASS) &&
+        !opt.classList.contains(HIDDEN_CLASS),
+    );
+
+    if (!enabledVisible.length) {
+      // No valid options left; just clear visual selection.
+      options.forEach(deselect);
+      return;
+    }
+
+    const currentlySelected = options.find((opt) =>
+      opt.classList.contains(SELECTED_CLASS)
+    );
+
+    const selectedStillValid = currentlySelected &&
+      enabledVisible.includes(currentlySelected);
+
+    if (selectedStillValid) {
+      const selectedValue = currentlySelected.dataset.selectorValue;
+      if (selectedValue && currentState[groupKey] !== selectedValue) {
+        updates[groupKey] = selectedValue;
+      }
+      return;
+    }
+
+    // Need a new selection: prefer a default option, otherwise the first
+    // enabled+visible option in DOM order.
+    const replacement = enabledVisible.find(isDefaultOption) ||
+      enabledVisible[0];
+    if (!replacement) return;
+
+    options.forEach(deselect);
+    select(replacement);
+
+    const newValue = replacement.dataset.selectorValue;
+    if (newValue && currentState[groupKey] !== newValue) {
+      updates[groupKey] = newValue;
+    }
+  });
+
+  const changedKeys = Object.keys(updates);
+  if (changedKeys.length > 0) {
+    setState(updates);
+    return true;
+  }
+  return false;
+}
+
+let isUpdatingVisibility = false;
+
+function updateVisibility() {
+  // Prevent re-entrancy if something triggers updateVisibility
+  // while it is already running.
+  if (isUpdatingVisibility) return;
+  isUpdatingVisibility = true;
+
+  try {
+    let stateChanged = false;
+    let iterations = 0;
+
+    // We may need multiple passes: reconciling selections can change the
+    // global state, which in turn affects show/disable conditions.
+    do {
+      document.querySelectorAll(COND_QUERY).forEach((elem) => {
+        // Show/hide only if element has show-when
+        if (elem.dataset.showWhen !== undefined) {
+          if (shouldBeShown(elem)) {
+            show(elem);
+          } else {
+            hide(elem);
+          }
+        }
+
+        // Enable/disable only if element has disable-when
+        if (elem.dataset.disableWhen !== undefined) {
+          if (shouldBeDisabled(elem)) {
+            disable(elem);
+          } else {
+            enable(elem);
+          }
+        }
+      });
+
+      stateChanged = reconcileGroupSelections();
+      iterations += 1;
+      // Hard stop to avoid infinite loops in case of conflicting rules.
+    } while (stateChanged && iterations < 5);
+
+    updateTOC2OptionsList();
+    updateTOC2ContentsList();
+  } finally {
+    isUpdatingVisibility = false;
+  }
+}
+
+// Initialization -------------------------------------------------------------
+
+domReady(() => {
+  const selectorOptions = document.querySelectorAll(OPTION_QUERY);
+  const initialState = {};
+
+  // Attach listeners and gather defaults
+  selectorOptions.forEach((option) => {
+    option.addEventListener("click", handleOptionSelect);
+    option.addEventListener("keydown", handleOptionKeydown);
+
+    if (isDefaultOption(option)) {
+      select(option);
+      const { selectorKey: key, selectorValue: value } = option.dataset;
+      if (key && value && initialState[key] === undefined) {
+        initialState[key] = value;
+      }
+    }
+  });
+
+  setState(initialState);
+  updateVisibility();
+
+  // Mark all selector groups as initialized to make them visible
+  document.querySelectorAll(GROUP_QUERY).forEach((group) => {
+    group.classList.add("rocm-docs-selector-initialized");
+  });
+});
--- a/docs/extension/rocm_docs_custom/static/selector/utils.js
+++ b/docs/extension/rocm_docs_custom/static/selector/utils.js
@@ -0,0 +1,14 @@
+export function domReady(callback) {
+  if (document.readyState !== "loading") {
+    callback();
+  } else {
+    document.addEventListener("DOMContentLoaded", callback, { once: true });
+  }
+}
+
+const DEBUG = true;
+export const logDebug = (...args) => {
+  if (DEBUG) {
+    console.debug("[ROCmDocsSelector]", ...args);
+  }
+};
--- a/docs/extension/rocm_docs_custom/table.py
+++ b/docs/extension/rocm_docs_custom/table.py
@@ -1,9 +0,0 @@
-from sphinx.util.docutils import SphinxDirective, directives, nodes
-from pathlib import Path
-
-def setup(app):
-    static_assets_dir = Path(__file__).parent / "static"
-    app.config.html_static_path.append(str(static_assets_dir))
-    app.add_css_file("table.css")
-
-    return {"version": "1.0", "parallel_read_safe": True}
--- a/docs/extension/rocm_docs_custom/templates/selector-toc2.html
+++ b/docs/extension/rocm_docs_custom/templates/selector-toc2.html
@@ -1,6 +1,7 @@
+<!-- Summary of selected options in secondary TOC -->
 <div class="tocsection onthispage">
-  <i class="fa-solid fa-filter"></i>
-  Options
+  <i class="fa-solid fa-computer"></i>
+  Installation environment
 </div>
 <nav class="page-toc rocm-docs-selector-toc2">
  <ul
@@ -8,6 +9,7 @@
  >
  </ul>
 </nav>
+<!-- Summary of page contents in secondary TOC -->
 <div class="page-toc tocsection onthispage">
  <i class="fa-solid fa-list"></i>
  Contents
--- a/docs/extension/rocm_docs_custom/utils.py
+++ b/docs/extension/rocm_docs_custom/utils.py
@@ -1,5 +1,6 @@
 import json
 import html
+from sphinx.util import logging

 def normalize_key(key):
    return key.replace(" ", "_").lower().strip()
@@ -28,3 +29,6 @@ def kv_to_data_attr(name, kv_str, separator="="):

    return f'data-{name}="{html.escape(json.dumps(pairs))}"' if pairs else ""

+
+logger = logging.getLogger(__name__)
+
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -2,16 +2,16 @@
   :description: Learn what ROCm is – AMD's open software stack for GPU programming, including runtimes, compilers, libraries, and tools for Linux and Windows.
   :keywords: ROCm, AMD, GPU computing, ROCm Core SDK, ROCm components, TheRock, ROCm architecture, HPC, AI, machine learning, ROCm runtime

-**********************
-AMD ROCm 7.9.0 preview
-**********************
+*******************************
+AMD ROCm |ROCM_VERSION| preview
+*******************************

-AMD ROCm is an open, modular, and high‑performance GPU software ecosystem —
-built collaboratively with the community, maintained transparently, and
-optimized for consistent, scalable performance across data centers, desktops,
-and edge devices.
+AMD ROCm is an open, modular, and high‑performance GPU software ecosystem
+— built collaboratively with the community, maintained transparently, and
+optimized for consistent, scalable performance across data centers,
+workstations, and edge devices.

-ROCm 7.9.0 is a technology preview release built with
+ROCm |ROCM_VERSION| is a technology preview release built with
 `TheRock <https://github.com/ROCm/TheRock>`__, AMD’s new open build and release
 system.
 This preview introduces a new modular build workflow that will become standard
@@ -34,11 +34,12 @@ frameworks such as PyTorch.
 * **Open source** -- Transparent development driven by community feedback
 * **Cross‑platform** -- Supports Linux and Windows environments
 * **Comprehensive** -- End‑to‑end toolchain from compilers to libraries
-* **Performance‑focused** -- Tuned for AMD Instinct™, AMD Radeon™, and AMD Ryzen™ architectures
+* **Performance‑focused** -- Tuned for AMD Instinct™, AMD Radeon™, and AMD Ryzen™ devices

 .. image:: data/rocm-ontology.png
   :align: center
   :alt: ROCm software ecosystem and components illustration
+   :width: 1000

 ROCm supports AMD GPU architectures spanning data center, workstation, and APU
 categories. TheRock enables a unified ROCm user‑space experience across
@@ -59,8 +60,8 @@ What’s changing
 ROCm is evolving to improve flexibility, maintainability, and
 use‑case alignment.

-* **Leaner core** – The Core SDK focuses on essential runtime and development components.  
-* **Use case‑specific expansions** – Optional domain‑specific SDKs for AI, data science, and HPC.  
+* **Leaner core** – The Core SDK focuses on essential runtime and development components.
+* **Use case‑specific expansions** – Optional domain‑specific SDKs for AI, data science, and HPC.
 * **Modular installation** – Install only the components required for your workflow.

 This approach streamlines installation, reduces footprint, and accelerates
@@ -76,6 +77,7 @@ computing.
 .. image:: data/rocm-sdk-arch.png
   :align: center
   :alt: ROCm Core SDK internal architecture illustration
+   :width: 1000

 The TheRock infrastructure keeps these components modular, consistent, and easy
 to integrate across configurations.
--- a/docs/install/build-from-source.rst
+++ b/docs/install/build-from-source.rst
@@ -0,0 +1,118 @@
+.. meta::
+   :description: Learn how to build the ROCm Core SDK from source using TheRock. Includes references to environment setup guides for Ubuntu 24.04 and Windows 11, plus links to official instructions and compatibility guidance.
+   :keywords: AMD ROCm Core SDK, build ROCm from source, TheRock, ROCm SDK, Ubuntu 24.04, Windows 11, ROCm environment setup, AMD GPU compute, ROCm compatibility, ROCm build guide
+
+***********************************
+Build the ROCm Core SDK from source
+***********************************
+
+You can build the ROCm Core SDK from source using the open-source unified build
+system `TheRock <https://github.com/ROCm/TheRock>`__. To learn more about the
+motivation and architecture behind this system, see `ROCm Technology Preview:
+ROCm Core SDK and TheRock Build System
+<https://rocm.blogs.amd.com/software-tools-optimization/therock/README.html>`__.
+
+This page consists mainly of key references to `TheRock's README
+<https://github.com/ROCm/TheRock?tab=readme-ov-file#building-from-source>`__
+and `supporting development manuals
+<https://github.com/ROCm/TheRock/blob/main/README.md#development-manuals>`__
+which provide up-to-date build instructions and guidance for supported
+platforms. See `TheRock Development Guide
+<https://github.com/ROCm/TheRock/blob/main/docs/development/development_guide.md#therock-development-guide>`__
+to learn about the overall build architecture.
+
+.. tip::
+
+   Building from source is recommended only if you need custom builds or are
+   contributing to ROCm development.
+   For most users, installing from official AMD releases is faster and easier.
+   See :doc:`/install/rocm` for installation instructions.
+
+Prerequisites
+=============
+
+A successful build depends on a correctly configured environment. Before you
+begin, ensure your system meets all hardware and software requirements. Review the
+following resources:
+
+* `Environment setup guide
+  <https://github.com/ROCm/TheRock/blob/main/docs/environment_setup_guide.md>`__
+
+* :doc:`/compatibility/compatibility-matrix`
+
+High-level build process
+========================
+
+For an overview of the build architecture, start with TheRock's `development guide
+<https://github.com/ROCm/TheRock/blob/main/docs/development/development_guide.md>`__.
+While specific commands vary by platform, the general workflow for building
+from source involves these stages:
+
+1. Clone the repository and install build dependencies. See :ref:`build-from-src-plat-setup`.
+
+2. Configure the build: Use CMake feature flags to configure the build. This
+   step allows you to target specific platforms, build subsets of ROCm Core SDK
+   components, and toggle component features. See `Build configuration
+   <https://github.com/ROCm/TheRock/blob/main/README.md#build-configuration>`__
+   for optional and required build flags.
+
+3. Execute the build: Run the build command to compile the source code. This
+   can be a time- and resource-intensive process. See `CMake build usage
+   <https://github.com/ROCm/TheRock/blob/main/README.md#cmake-build-usage>`__.
+
+4. After a successful build, the outputs are available for use in downstream
+   tasks. To learn more about build outputs, see the relevant `TheRock
+   documentation <https://github.com/ROCm/TheRock/blob/main/docs/development/artifacts.md>`__.
+   Common post-build tasks include:
+
+   * Using ``build/dist/rocm``: When the build completes, you should have a
+     build of ROCm in the ``build/dist/rocm/`` directory. See `Using installed
+     tarballs <https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-installed-tarballs>`__
+     for more information.
+
+   * Building Python packages: Prepare the build artifacts for distribution as
+     Python packages. See `Building Python packages
+     <https://github.com/ROCm/TheRock/blob/main/docs/packaging/python_packaging.md#building-packages>`__.
+
+   * Building PyTorch: Build a compatible PyTorch version against ROCm wheels.
+     See the `PyTorch build instructions
+     <https://github.com/ROCm/TheRock/tree/main/external-builds/pytorch#build-instructions>`__.
+
+.. _build-from-src-plat-setup:
+
+Platform-specific setup
+=======================
+
+ManyLinux
+---------
+
+On Linux, it's recommended to build with ManyLinux to produce binaries that are
+portable across Ubuntu and other Linux distributions. To learn more about what
+a ROCm ManyLinux build entails, see `ManyLinux builds
+<https://github.com/ROCm/TheRock/blob/main/docs/design/manylinux_builds.md>`__.
+Refer to `ManyLinux x86_84
+<https://github.com/ROCm/TheRock/blob/main/docs/environment_setup_guide.md#manylinux-x84-64>`__
+in the environment setup guide.
+
+Ubuntu 24.04
+------------
+
+TheRock provides detailed instructions and scripts for preparing an Ubuntu
+24.04 system, including installing necessary packages via apt.
+Refer to `Setup — Ubuntu 24.04 <https://github.com/ROCm/TheRock?tab=readme-ov-file#setup---ubuntu-2404>`__
+in the TheRock repository for guidance.
+
+Windows 11
+----------
+
+For setup instructions on Windows 11 using Visual Studio 2022, see
+`Setup — Windows 11
+<https://github.com/ROCm/TheRock?tab=readme-ov-file#setup---windows-11-vs-2022>`__
+in the TheRock repository.
+
+.. seealso::
+
+   For details on supported configurations, known issues, and other
+   Windows-specific considerations, review the `Windows support
+   <https://github.com/ROCm/TheRock/blob/main/docs/development/windows_support.md>`__
+   documentation.
--- a/docs/install/compatibility-matrix.md
+++ b/docs/install/compatibility-matrix.md
--- a/docs/install/includes/1_rhel-10.0-tar-prerequisites.md
+++ b/docs/install/includes/1_rhel-10.0-tar-prerequisites.md
@@ -1,21 +0,0 @@
-1. Register your Enterprise Linux.
-
-   ```bash
-   subscription-manager register --username <username> --password <password>
-   ```
-
-2. Update your Enterprise Linux.
-
-   ```bash
-   sudo dnf update --releasever=10.0 --exclude=\*release\*
-   ```
-
-3. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_rhel-10.0-wheel-prerequisites.md
+++ b/docs/install/includes/1_rhel-10.0-wheel-prerequisites.md
@@ -1,27 +0,0 @@
-1. Register your Enterprise Linux.
-
-   ```bash
-   subscription-manager register --username <username> --password <password>
-   ```
-
-2. Update your Enterprise Linux.
-
-   ```bash
-   sudo dnf update --releasever=10.0 --exclude=\*release\*
-   ```
-
-3. Install Python 3.12 or 3.13.
-
-   ```bash
-   sudo dnf install python3.12 python3.12-pip
-   ```
-
-4. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_rhel-9.6-tar-prerequisites.md
+++ b/docs/install/includes/1_rhel-9.6-tar-prerequisites.md
@@ -1,22 +0,0 @@
-1. Register your Enterprise Linux.
-
-   ```bash
-   subscription-manager register --username <username> --password <password>
-   sudo subscription-manager attach --auto
-   ```
-
-2. Update your Enterprise Linux.
-
-   ```bash
-   sudo dnf update --releasever=9.6 --exclude=\*release\*
-   ```
-
-3. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_rhel-9.6-wheel-prerequisites.md
+++ b/docs/install/includes/1_rhel-9.6-wheel-prerequisites.md
@@ -1,28 +0,0 @@
-1. Register your Enterprise Linux.
-
-   ```bash
-   subscription-manager register --username <username> --password <password>
-   sudo subscription-manager attach --auto
-   ```
-
-2. Update your Enterprise Linux.
-
-   ```bash
-   sudo dnf update --releasever=9.6 --exclude=\*release\*
-   ```
-
-3. Install Python 3.11, 3.12 or 3.13.
-
-   ```bash
-   sudo dnf install python3.11 python3.11-pip
-   ```
-
-4. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_ubuntu-22.04-wheel-prerequisites.md
+++ b/docs/install/includes/1_ubuntu-22.04-wheel-prerequisites.md
@@ -1,15 +0,0 @@
-1. Install Python 3.11.
-
-   ```bash
-   sudo apt install python3.11 python3.11-venv
-   ```
-
-2. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_ubuntu-24.04-wheel-prerequisites.md
+++ b/docs/install/includes/1_ubuntu-24.04-wheel-prerequisites.md
@@ -1,15 +0,0 @@
-1. Install Python 3.12 or 3.13.
-
-   ```bash
-   sudo apt install python3.12 python3.12-venv
-   ```
-
-2. Configure permissions for GPU access.
-
-   ```bash
-   sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-   ```
-
-   ```{note}
-   To apply all settings, reboot your system.
-   ```
--- a/docs/install/includes/1_ubuntu-tar-prerequisites.md
+++ b/docs/install/includes/1_ubuntu-tar-prerequisites.md
@@ -1,9 +0,0 @@
-Configure permissions for GPU access.
-
-```bash
-sudo usermod -a -G render,video $LOGNAME # Add the current user to the render and video groups
-```
-
-```{note}
-To apply all settings, reboot your system.
-```
--- a/docs/install/includes/1_windows-tar-prerequisites.md
+++ b/docs/install/includes/1_windows-tar-prerequisites.md
@@ -1,6 +0,0 @@
-1. Remove any existing HIP SDK installations and other
-   conflicting AMD graphics software.
-
-2. Install the [Adrenalin Driver version
-   25.9.2](https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-9-2.html).
-   For instructions, see [Install AMD Software: Adrenalin Edition](https://www.amd.com/en/resources/support-articles/faqs/RSX2-INSTALL.html).
--- a/docs/install/includes/1_windows-wheel-prerequisites.md
+++ b/docs/install/includes/1_windows-wheel-prerequisites.md
@@ -1,8 +0,0 @@
-1. Remove any existing HIP SDK installations and other
-   conflicting AMD graphics software.
-
-2. Install the [Adrenalin Driver version
-   25.9.2](https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-9-2.html).
-   For instructions, see [Install AMD Software: Adrenalin Edition](https://www.amd.com/en/resources/support-articles/faqs/RSX2-INSTALL.html).
-
-3. Install a supported Python version: 3.11, 3.12, or 3.13.
--- a/docs/install/includes/2_rhel-instinct-install-kmd.md
+++ b/docs/install/includes/2_rhel-instinct-install-kmd.md
@@ -1,6 +0,0 @@
-For information about driver compatibility, see the {doc}`compatibility-matrix`.
-
-For information about the AMD GPU driver installation, see the
-[RHEL native
-installation](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-rhel.html)
-in the AMD Instinct Data Center GPU Documentation.
--- a/docs/install/includes/2_ubuntu-instinct-install-kmd.md
+++ b/docs/install/includes/2_ubuntu-instinct-install-kmd.md
@@ -1,6 +0,0 @@
-For information about driver compatibility, see the {doc}`compatibility-matrix`.
-
-For information about the AMD GPU driver installation, see the
-[Ubuntu native
-installation](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-ubuntu.html)
-in the AMD Instinct Data Center GPU Documentation.
--- a/docs/install/includes/3_tar-gfx1151-install-rocm.md
+++ b/docs/install/includes/3_tar-gfx1151-install-rocm.md
@@ -1,20 +0,0 @@
-1. Create the installation directory. For example:
-
-   ```bash
-   mkdir therock-tarball && cd therock-tarball
-   ```
-
-   ```{note}
-   Subsequent commands assume you're working with the
-   `therock-tarball` directory.
-   If you choose a different directory name, adjust the
-   subsequent commands accordingly.
-   ```
-
-2. Download and unpack the tarball.
-
-   ```bash
-   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.9.0rc1.tar.gz
-   mkdir install
-   tar -xf *.tar.gz -C install
-   ```
--- a/docs/install/includes/3_tar-gfx942-install-rocm.md
+++ b/docs/install/includes/3_tar-gfx942-install-rocm.md
@@ -1,20 +0,0 @@
-1. Create the installation directory. For example:
-
-   ```bash
-   mkdir therock-tarball && cd therock-tarball
-   ```
-
-   ```{note}
-   Subsequent commands assume you're working with the
-   `therock-tarball` directory.
-   If you choose a different directory name, adjust the
-   subsequent commands accordingly.
-   ```
-
-2. Download and unpack the tarball.
-
-   ```bash
-   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.9.0rc1.tar.gz
-   mkdir install
-   tar -xf *.tar.gz -C install
-   ```
--- a/docs/install/includes/3_tar-gfx950-install-rocm.md
+++ b/docs/install/includes/3_tar-gfx950-install-rocm.md
@@ -1,20 +0,0 @@
-1. Create the installation directory. For example:
-
-   ```bash
-   mkdir therock-tarball && cd therock-tarball
-   ```
-
-   ```{note}
-   Subsequent commands assume you're working with the
-   `therock-tarball` directory.
-   If you choose a different directory name, adjust the
-   subsequent commands accordingly.
-   ```
-
-2. Download and unpack the tarball.
-
-   ```bash
-   wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.9.0rc1.tar.gz
-   mkdir install
-   tar -xf *.tar.gz -C install
-   ```
--- a/docs/install/includes/3_wheel-gfx1151-install-rocm.md
+++ b/docs/install/includes/3_wheel-gfx1151-install-rocm.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.12 -m venv .venv
-   source .venv/bin/activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/3_wheel-gfx942-install-rocm-py311.md
+++ b/docs/install/includes/3_wheel-gfx942-install-rocm-py311.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.11 -m venv .venv
-   source .venv/bin/activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/3_wheel-gfx942-install-rocm.md
+++ b/docs/install/includes/3_wheel-gfx942-install-rocm.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.12 -m venv .venv
-   source .venv/bin/activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/3_wheel-gfx950-install-rocm-py311.md
+++ b/docs/install/includes/3_wheel-gfx950-install-rocm-py311.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.11 -m venv .venv
-   source .venv/bin/activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/3_wheel-gfx950-install-rocm.md
+++ b/docs/install/includes/3_wheel-gfx950-install-rocm.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.12 -m venv .venv
-   source .venv/bin/activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/3_windows-tar-install-rocm.md
+++ b/docs/install/includes/3_windows-tar-install-rocm.md
@@ -1,47 +0,0 @@
-```{important}
- Do not copy/replace the ROCm-SDK compiler and runtime DLLs to
-`System32` as this can cause conflicts.
-
- Disable the following Windows security features as they
-  can interfere with ROCm functionality:
-
-  - Turn off WDAG (Windows Defender Application Guard)
-    - Control Panel > Programs > Programs and Features > Turn Windows features on or off > **Deselect** "Microsoft Defender Application Guard"
-  - Turn off SAC (Smart App Control)
-    - Settings > Privacy & security > Windows Security > App & browser control > Smart App Control settings > **Off**
-```
-
-1. Create the installation directory in `C:\TheRock\build`.
-
-   ```{note}
-   Subsequent commands assume you're working with the
-   `C:\TheRock\build` directory.
-   ```
-
-2. Download the tarball and extract the contents to
-   `C:\TheRock\build`.
-
-   - Download link: [https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.9.0rc1.tar.gz](https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.9.0rc1.tar.gz)
-
-3. Set the following environment variables using the command
-   prompt as an administrator:
-
-   ```bat
-   setx HIP_DEVICE_LIB_PATH “C:\TheRock\build\lib\llvm\amdgcn\bitcode” /M
-   setx HIP_PATH “C:\TheRock\build” /M
-   setx HIP_PLATFORM “amd” /M
-   setx LLVM_PATH “C:\TheRock\build\lib\llvm” /M
-   ```
-
-4. Add the following paths into PATH environment variable using your system settings GUI.
-
-   - `C:\TheRock\build\bin`
-
-   - `C:\TheRock\build\lib\llvm\bin`
-
-5. Open a new command prompt window for the environment variables to take effect. Run `set`
-   to see the list of active variables.
-
-   ```bat
-   set
-   ````
--- a/docs/install/includes/3_windows-wheel-install-rocm.md
+++ b/docs/install/includes/3_windows-wheel-install-rocm.md
@@ -1,12 +0,0 @@
-1. Set up your Python virtual environment.
-
-   ```bash
-   python3.12 -m venv .venv
-   .venv\Scripts\activate
-   ```
-
-2. Install ROCm wheels packages.
-
-   ```bash
-   python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
-   ```
--- a/docs/install/includes/4_linux-tar-post-install.md
+++ b/docs/install/includes/4_linux-tar-post-install.md
@@ -1,55 +0,0 @@
-1. Configure ROCm PATH. Make sure you're in the `therock-tarball` directory before proceeding.
-
-   ```bash
-   export ROCM_PATH=$PWD
-   export PATH=$PATH:$ROCM_PATH/install/bin
-   ```
-
-2. Configure `LD_LIBRARY_PATH`.
-
-   ```bash
-   export LD_LIBRARY_PATH=$ROCM_PATH/install/lib
-   ```
-
-3. Verify the ROCm installation.
-
-   ```bash
-   rocminfo
-   amd-smi
-   ```
-
-   ```{eval-rst}
-
-   .. dropdown:: Example output of ``rocminfo``
-
-      .. code-block:: shell-session
-
-         ROCk module is loaded
-         =====================    
-         HSA System Attributes    
-         =====================    
-         Runtime Version:         1.18
-         Runtime Ext Version:     1.14
-         System Timestamp Freq.:  1000.000000MHz
-         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
-         Machine Model:           LARGE                              
-         System Endianness:       LITTLE                             
-         Mwaitx:                  DISABLED
-         XNACK enabled:           NO
-         DMAbuf Support:          YES
-         VMM Support:             YES
-     
-         ==========               
-         HSA Agents               
-         ==========               
-         *******                  
-         Agent 1                  
-         *******                  
-           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Uuid:                    CPU-XX                             
-           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Vendor Name:             CPU
-
-         [output truncated]
-   ```
-
--- a/docs/install/includes/4_rhel-wheel-post-install.md
+++ b/docs/install/includes/4_rhel-wheel-post-install.md
@@ -1,72 +0,0 @@
-1. Verify the ROCm installation.
-
-   ```bash
-   rocminfo
-   amd-smi
-   ```
-
-   ```{eval-rst}
-
-   .. dropdown:: Example output of ``rocminfo``
-
-      .. code-block:: shell-session
-
-         ROCk module is loaded
-         =====================    
-         HSA System Attributes    
-         =====================    
-         Runtime Version:         1.18
-         Runtime Ext Version:     1.14
-         System Timestamp Freq.:  1000.000000MHz
-         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
-         Machine Model:           LARGE                              
-         System Endianness:       LITTLE                             
-         Mwaitx:                  DISABLED
-         XNACK enabled:           NO
-         DMAbuf Support:          YES
-         VMM Support:             YES
-     
-         ==========               
-         HSA Agents               
-         ==========               
-         *******                  
-         Agent 1                  
-         *******                  
-           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Uuid:                    CPU-XX                             
-           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Vendor Name:             CPU
-
-         [output truncated]
-   ```
-
-2. Inspect your ROCm installation in your Python environment.
-
-   ```bash
-   pip freeze | grep rocm
-   which rocm-sdk
-   ls .venv/bin
-   ```
-
-3. Test your ROCm installation.
-
-   ```bash
-   rocm-sdk targets
-   rocm-sdk path --cmake
-   rocm-sdk path --bin
-   rocm-sdk path --root
-   rocm-sdk test
-   ```
-
-   To learn more about the `rocm-sdk` tool and to see example expected outputs,
-   see [Using ROCm Python packages
-   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
-
-````{tip}
-If you need to deactivate your Python virtual environment when finished,
-run:
-
-```shell
-deactivate
-```
-````
--- a/docs/install/includes/4_ubuntu-wheel-post-install.md
+++ b/docs/install/includes/4_ubuntu-wheel-post-install.md
@@ -1,72 +0,0 @@
-1. Verify the ROCm installation.
-
-   ```bash
-   rocminfo
-   amd-smi
-   ```
-
-   ```{eval-rst}
-
-   .. dropdown:: Example output of ``rocminfo``
-
-      .. code-block:: shell-session
-
-         ROCk module is loaded
-         =====================    
-         HSA System Attributes    
-         =====================    
-         Runtime Version:         1.18
-         Runtime Ext Version:     1.14
-         System Timestamp Freq.:  1000.000000MHz
-         Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
-         Machine Model:           LARGE                              
-         System Endianness:       LITTLE                             
-         Mwaitx:                  DISABLED
-         XNACK enabled:           NO
-         DMAbuf Support:          YES
-         VMM Support:             YES
-     
-         ==========               
-         HSA Agents               
-         ==========               
-         *******                  
-         Agent 1                  
-         *******                  
-           Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Uuid:                    CPU-XX                             
-           Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
-           Vendor Name:             CPU
-
-         [output truncated]
-   ```
-
-2. Inspect your ROCm installation in your Python environment.
-
-   ```bash
-   pip freeze | grep rocm
-   which rocm-sdk
-   ls .venv/bin
-   ```
-
-3. Test your ROCm installation.
-
-   ```bash
-   rocm-sdk targets
-   rocm-sdk path --cmake
-   rocm-sdk path --bin
-   rocm-sdk path --root
-   rocm-sdk test
-   ```
-
-   To learn more about the `rocm-sdk` tool and to see example expected outputs,
-   see [Using ROCm Python packages
-   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
-
-````{tip}
-If you need to deactivate your Python virtual environment when finished,
-run:
-
-```shell
-deactivate
-```
-````
--- a/docs/install/includes/4_windows-tar-post-install.md
+++ b/docs/install/includes/4_windows-tar-post-install.md
@@ -1,23 +0,0 @@
-Verify the ROCm installation.
-
-```shell
-hipinfo
-```
-
-```{eval-rst}
-
-.. dropdown:: Example output of ``hipinfo``
-
-   .. code-block:: shell-session
-
-      --------------------------------------------------------------------------------
-      device#                           0
-      Name:                             AMD Radeon(TM) 8060S Graphics
-      pciBusID:                         197
-      pciDeviceID:                      0
-      pciDomainID:                      0
-      multiProcessorCount:              20
-
-      [output truncated]
-```
-
--- a/docs/install/includes/4_windows-wheel-post-install.md
+++ b/docs/install/includes/4_windows-wheel-post-install.md
@@ -1,50 +0,0 @@
-1. Verify the ROCm installation.
-
-   ```bash
-   hipinfo
-   ```
-
-   ```{eval-rst}
-
-   .. dropdown:: Example output of ``hipinfo``
-
-      .. code-block:: shell-session
-
-         --------------------------------------------------------------------------------
-         device#                           0
-         Name:                             AMD Radeon(TM) 8060S Graphics
-         pciBusID:                         197
-         pciDeviceID:                      0
-         pciDomainID:                      0
-         multiProcessorCount:              20
-
-         [output truncated]
-   ```
-
-
-2. Inspect your ROCm installation in your Python environment.
-
-   ```bash
-   pip freeze
-   where rocm-sdk
-   dir .venv\Scripts
-   ```
-
-3. Test your ROCm installation.
-
-   ```bash
-   rocm-sdk test
-   ```
-
-   To learn more about the `rocm-sdk` tool and to see example expected outputs,
-   see [Using ROCm Python packages
-   (TheRock)](https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages).
-
-````{tip}
-If you need to deactivate your Python virtual environment when finished,
-run:
-
-```shell
-deactivate
-```
-````
--- a/docs/install/includes/5_tar-uninstall.md
+++ b/docs/install/includes/5_tar-uninstall.md
@@ -1,5 +0,0 @@
-To uninstall ROCm, remove your installation directory.
-
-```bash
-sudo rm -rf therock-tarball
-```
--- a/docs/install/includes/5_wheel-linux-uninstall.md
+++ b/docs/install/includes/5_wheel-linux-uninstall.md
@@ -1,11 +0,0 @@
-1. Clear the pip cache.
-
-   ```bash
-   sudo rm -rf ~/.cache/pip
-   ```
-
-2. Remove your local Python virtual environment.
-
-   ```bash
-   sudo rm -rf .venv
-   ```
--- a/docs/install/includes/5_wheel-windows-uninstall.md
+++ b/docs/install/includes/5_wheel-windows-uninstall.md
@@ -1,11 +0,0 @@
-1. Clear the pip cache.
-
-   ```bash
-   pip cache purge
-   ```
-
-2. Remove your local Python virtual environment.
-
-   ```bash
-   rmdir /s /q .venv
-   ```
--- a/docs/install/includes/5_windows-tar-uninstall.md
+++ b/docs/install/includes/5_windows-tar-uninstall.md
@@ -1,18 +0,0 @@
-1. Delete the `C:\TheRock\build` and its contents.
-
-2. Delete the environment variables. For example, using Powershell as an administrator:
-
-  ```powershell
-  [Environment]::SetEnvironmentVariable("HIP_PATH", $null, "Machine")
-  [Environment]::SetEnvironmentVariable("HIP_DEVICE_LIB_PATH", $null, "Machine")
-  [Environment]::SetEnvironmentVariable("HIP_PLATFORM", $null, "Machine")
-  [Environment]::SetEnvironmentVariable("LLVM_PATH", $null, "Machine")
-  ```
-
-3. Remove the following paths from your PATH environment variable using your system settings GUI.
-
-   - `C:\TheRock\build\bin`
-
-   - `C:\TheRock\build\lib\llvm\bin`
-
-4. If you want to uninstall the Adrenalin driver, see [Uninstall AMD Software](https://www.amd.com/en/resources/support-articles/faqs/RSX2-UNINSTALL.html).
--- a/docs/install/includes/6_rhel-troubleshooting.md
+++ b/docs/install/includes/6_rhel-troubleshooting.md
@@ -1,8 +0,0 @@
-Docker images often only include a minimal set of installations, meaning some
-essential packages might be missing. When installing ROCm within a Docker
-container, you might need to install additional packages for a successful
-installation. Use the following commands to install the prerequisite packages.
-
-```bash
-dnf install sudo libatomic
-```
--- a/docs/install/includes/6_ubuntu-troubleshooting.md
+++ b/docs/install/includes/6_ubuntu-troubleshooting.md
@@ -1,9 +0,0 @@
-Docker images often only include a minimal set of installations, meaning some
-essential packages might be missing. When installing ROCm within a Docker
-container, you might need to install additional packages for a successful
-installation. Use the following commands to install the prerequisite packages.
-
-```bash
-apt update
-apt install sudo wget
-```
--- a/docs/install/includes/install.rst
+++ b/docs/install/includes/install.rst
@@ -0,0 +1,395 @@
+Installation
+============
+
+.. dropdown:: Installation environment
+   :animate: fade-in-slide-down
+   :icon: desktop-download
+   :chevron: down-up
+
+   .. include:: ./includes/selector.rst
+
+Before getting started, make sure you've completed the :ref:`rocm-prerequisites`.
+For information about supported operating systems and compatible AMD devices,
+see the :doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
+
+.. selected:: os=windows
+
+   .. caution::
+
+      Do not copy/replace the ROCm compiler and runtime DLLs to System32 as
+      this can cause conflicts.
+
+.. selected:: fam=instinct fam=radeon-pro fam=radeon
+
+   .. selected:: os=ubuntu
+      :heading: Install kernel driver
+      :heading-level: 3
+
+      For information about AMD GPU Driver (amdgpu) compatibility, see the
+      :doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
+
+      For instructions on installing the AMD GPU Driver (amdgpu), see `Ubuntu native
+      installation
+      <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-ubuntu.html>`__
+      in the AMD Instinct Data Center GPU Documentation.
+
+   .. selected:: os=rhel
+      :heading: Install kernel driver
+      :heading-level: 3
+
+      For information about AMD GPU Driver (amdgpu) compatibility, see the
+      :doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
+
+      For instructions on installing the AMD GPU Driver (amdgpu), see `RHEL native
+      installation
+      <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-rhel.html>`__
+      in the AMD Instinct Data Center GPU Documentation.
+
+   .. selected:: os=sles
+      :heading: Install kernel driver
+      :heading-level: 3
+
+      For information about AMD GPU Driver (amdgpu) compatibility, see the
+      :doc:`Compatibility matrix </compatibility/compatibility-matrix>`.
+
+      For instructions on installing the AMD GPU Driver (amdgpu), see `SLES native
+      installation
+      <https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/package-manager/package-manager-sles.html>`__
+      in the AMD Instinct Data Center GPU Documentation.
+
+.. selected:: fam=ryzen
+
+   .. selected:: os=ubuntu os=rhel os=sles
+      :heading: About the kernel driver
+      :heading-level: 3
+
+      Supported Ryzen AI APUs require the inbox kernel driver included with
+      Ubuntu 24.04.3.
+
+Install ROCm
+------------
+
+Use the following instructions to install the ROCm Core SDK on your system.
+
+.. selected:: i=pip
+   :heading: Set up your Python virtual environment
+   :heading-level: 4
+
+   Create and activate the Python virtual environment where you'll install
+   ROCm packages.
+
+   .. selected:: os=ubuntu
+
+      .. selected:: os-version=24
+
+         For example, to create and activate a Python 3.12 virtual environment,
+         run the following command:
+
+         .. code-block:: bash
+
+            python3.12 -m venv .venv
+            source .venv/bin/activate
+
+      .. selected:: os-version=22
+
+         For example, to create and activate a Python 3.11 virtual environment,
+         run the following command:
+
+         .. code-block:: bash
+
+            python3.11 -m venv .venv
+            source .venv/bin/activate
+
+   .. selected:: os=rhel
+
+      .. selected:: os-version=10.1 os-version=10.0
+
+         For example, to create and activate a Python 3.12 virtual environment,
+         run the following command:
+
+         .. code-block:: bash
+
+            python3.12 -m venv .venv
+            source .venv/bin/activate
+
+      .. selected:: os-version=9.7 os-version=9.6
+
+         For example, to create and activate a Python 3.11 virtual environment,
+         run the following command:
+
+         .. code-block:: bash
+
+            python3.11 -m venv .venv
+            source .venv/bin/activate
+
+      .. selected:: os-version=8
+
+         For example, to create and activate a Python 3.11 virtual environment,
+         run the following command:
+
+         .. code-block:: bash
+
+            python3.11 -m venv .venv
+            source .venv/bin/activate
+
+   .. selected:: os=sles
+
+      For example, to create and activate a Python 3.11 virtual environment,
+      run the following command:
+
+      .. code-block:: bash
+
+         python3.11 -m venv .venv
+         source .venv/bin/activate
+
+   .. selected:: os=windows
+
+      For example, to create and activate a Python 3.12 virtual environment,
+      run the following command:
+
+      .. code-block:: bat
+
+         python3.12 -m venv .venv
+         .venv\Scripts\activate
+
+.. selected:: i=pip
+   :heading: Install ROCm wheel packages
+   :heading-level: 4
+
+   .. selected:: gfx=950
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx950`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=942
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx942`` device.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=90a
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx90a`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=1100
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx1100`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=1101
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx1101`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=1150
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx1150`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ "rocm[libraries,devel]"
+
+   .. selected:: gfx=1151
+
+      Use pip to install the ROCm Core SDK libraries and development tools for
+      your ``gfx1151`` GPU.
+
+      Run the following command:
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ "rocm[libraries,devel]"
+
+.. selected:: i=tar
+   :heading: Create the installation directory
+   :heading-level: 4
+
+   .. selected:: os=ubuntu os=rhel os=sles
+
+      Run the following command in your desired location to create your
+      installation directory:
+
+      .. code-block:: bash
+
+         mkdir therock-tarball && cd therock-tarball
+
+      .. important::
+
+         Subsequent commands assume you're working with the ``therock-tarball``
+         directory. If you choose a different directory name, adjust the
+         commands accordingly.
+
+
+   .. selected:: os=windows
+
+      Create the installation directory in ``C:\TheRock\build``.
+
+      .. important::
+
+         Subsequent commands assume you're working with the
+         ``C:\TheRock\build`` directory. If you choose a different directory
+         name, adjust the commands accordingly.
+
+.. selected:: i=tar
+   :heading: Download and unpack the tarball
+   :heading-level: 4
+
+   .. selected:: os=ubuntu os=rhel os=sles
+
+      .. selected:: gfx=950
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx950`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx950-dcgpu-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=942
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx942`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx94X-dcgpu-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=90a
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx90a`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx90X-dcgpu-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=1100
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx1100`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-dgpu-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=1101
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx1101`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx110X-dgpu-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=1150
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx1150`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1150-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+      .. selected:: gfx=1151
+
+         Use the following commands to download and untar the ROCm tarball for
+         your ``gfx1151`` GPU.
+
+         Run the following command:
+
+         .. code-block:: bash
+
+            wget https://repo.amd.com/rocm/tarball/therock-dist-linux-gfx1151-7.10.0.tar.gz
+            mkdir install
+            tar -xf *.tar.gz -C install
+
+   .. selected:: os=windows
+
+      .. selected:: gfx=1100
+
+         Download the tarball for your ``gfx1100`` GPU and extract the contents
+         to ``C:\TheRock\build``.
+
+         - Download link: `therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz
+           <https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz>`__
+
+      .. selected:: gfx=1101
+
+         Download the tarball for your ``gfx1101`` GPU and extract the contents
+         to ``C:\TheRock\build``.
+
+         - Download link: `therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz
+           <https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx110X-dgpu-7.10.0.tar.gz>`__
+
+      .. selected:: gfx=1150
+
+         Download the tarball for your ``gfx1150`` GPU and extract the contents
+         to ``C:\TheRock\build``.
+
+         - Download link: `therock-dist-windows-gfx1150-7.10.0.tar.gz
+           <https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1150-7.10.0.tar.gz>`__
+
+      .. selected:: gfx=1151
+
+         Download the tarball for your ``gfx1151`` GPU and extract the contents
+         to ``C:\TheRock\build``.
+
+         - Download link: `therock-dist-windows-gfx1151-7.10.0.tar.gz
+           <https://repo.amd.com/rocm/tarball/therock-dist-windows-gfx1151-7.10.0.tar.gz>`__
--- a/docs/install/includes/post-install.rst
+++ b/docs/install/includes/post-install.rst
@@ -0,0 +1,316 @@
+Post-installation
+=================
+
+.. dropdown:: Installation environment
+   :animate: fade-in-slide-down
+   :icon: desktop-download
+   :chevron: down-up
+
+   .. include:: ./includes/selector.rst
+
+After installing the ROCm Core SDK |ROCM_VERSION| -- see :ref:`rocm-install` --
+complete these post-installation steps to complete your system configuration
+and validate the installation.
+
+.. selected:: i=tar
+
+   .. selected:: os=ubuntu os=rhel os=sles
+      :heading: Configure your environment
+      :heading-level: 3
+
+      Configure environment variables so that ROCm libraries and tools are
+      available either to all users on the system or only to your user account.
+
+      .. _rocm-post-install-system-wide:
+
+      .. tab-set::
+
+         .. tab-item:: System-wide setup
+
+            Create a profile script so that all users inherit the ROCm
+            environment variables when they start a shell session. Make sure
+            you're in the ``therock-tarball`` directory before proceeding.
+
+            .. code-block:: bash
+
+               # Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding.
+               ROCM_INSTALL_PATH=$(pwd)/install
+               sudo tee /etc/profile.d/set-rocm-env.sh << EOF
+               export ROCM_PATH=$ROCM_INSTALL_PATH
+               export PATH=\$PATH:\$ROCM_PATH/bin
+               export LD_LIBRARY_PATH=\$ROCM_PATH/lib
+               EOF
+               sudo chmod +x /etc/profile.d/set-rocm-env.sh
+               source /etc/profile.d/set-rocm-env.sh
+
+         .. tab-item:: User setup
+
+            Configure the ROCm environment for your user by updating your shell
+            configuration file.
+
+            1. Add the following to your shell configuration file
+               (``~/.bashrc``, ``~/.profile``). Make sure you're in the
+               ``therock-tarball`` directory before proceeding.
+
+               .. code-block:: bash
+
+                  # Configure ROCm PATH. Make sure you're in the therock-tarball directory before proceeding.
+                  export ROCM_PATH=$PWD/install
+                  export PATH=$PATH:$ROCM_PATH/bin
+                  export LD_LIBRARY_PATH=$ROCM_PATH/lib
+
+            2. After modifying your shell configuration, apply the change to
+               your current session by sourcing your updated shell
+               configuration file.
+
+               .. tab-set::
+
+                  .. tab-item:: .bashrc
+
+                     .. code-block:: bash
+
+                        source ~/.bashrc
+
+                  .. tab-item:: .profile
+
+                     .. code-block:: bash
+
+                        source ~/.profile
+
+   .. selected:: os=windows
+      :heading: Configure your environment
+      :heading-level: 3
+
+      Configure environment variables so that ROCm libraries and tools are
+      available on your Windows system.
+
+      1. Set the following environment variables using the command
+         prompt as an administrator:
+
+         .. code-block:: bat
+
+            setx HIP_DEVICE_LIB_PATH “C:\TheRock\build\lib\llvm\amdgcn\bitcode” /M
+            setx HIP_PATH “C:\TheRock\build” /M
+            setx HIP_PLATFORM “amd” /M
+            setx LLVM_PATH “C:\TheRock\build\lib\llvm” /M
+
+      2. Add the following paths into PATH environment variable using your system settings GUI.
+
+         - ``C:\TheRock\build\bin``
+
+         - ``C:\TheRock\build\lib\llvm\bin``
+
+      3. Open a new command prompt window for the environment variables to take effect. Run ``set``
+         to see the list of active variables.
+
+         .. code-block:: bat
+
+            set
+
+.. selected:: os=ubuntu os=rhel os=sles
+   :heading: Verify your installation
+   :heading-level: 3
+
+   Use the following ROCm tools to verify that the ROCm stack is correctly
+   installed and that your AMD GPU is visible to the system.
+
+   1. Use ``rocminfo`` to list detected AMD GPUs and confirm that the ROCm
+      runtimes and drivers are correctly installed and loaded.
+
+      .. code-block:: bash
+
+         rocminfo
+
+      .. dropdown:: Example output of ``rocminfo``
+         :animate: fade-in-slide-down
+         :color: success
+         :icon: note
+         :chevron: down-up
+
+         .. code-block:: shell-session
+
+            ROCk module is loaded
+            =====================
+            HSA System Attributes
+            =====================
+            Runtime Version:         1.18
+            Runtime Ext Version:     1.14
+            System Timestamp Freq.:  1000.000000MHz
+            Sig. Max Wait Duration:  18446744073709551615 (0xFFFFFFFFFFFFFFFF) (timestamp count)
+            Machine Model:           LARGE
+            System Endianness:       LITTLE
+            Mwaitx:                  DISABLED
+            XNACK enabled:           NO
+            DMAbuf Support:          YES
+            VMM Support:             YES
+
+            ==========
+            HSA Agents
+            ==========
+            *******
+            Agent 1
+            *******
+              Name:                    AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+              Uuid:                    CPU-XX
+              Marketing Name:          AMD RYZEN AI MAX+ PRO 395 w/ Radeon 8060S
+              Vendor Name:             CPU
+
+            ... [output truncated]
+
+   2. Use the AMD SMI CLI ``amd-smi`` to validate system information.
+
+      .. code-block:: bash
+
+         amd-smi version
+
+      .. dropdown:: Example output of ``amd-smi version``
+         :animate: fade-in-slide-down
+         :color: success
+         :icon: note
+         :chevron: down-up
+
+         .. code-block:: shell-session
+
+            AMDSMI Tool: 26.1.0+cd50d9e0 | AMDSMI Library version: 26.1.0 | ROCm version: 7.10.0 | amdgpu version: 6.16.6 | amd_hsmp version: N/A
+
+   .. selected:: i=pip
+
+      3. Inspect your installation in your Python environment and confirm that
+         ROCm packages, including the ``rocm-sdk`` CLI, are available.
+
+         .. code-block:: bash
+
+            pip freeze | grep rocm
+            which rocm-sdk
+            ls .venv/bin
+
+.. selected:: os=windows
+   :heading: Verify your installation
+   :heading-level: 3
+
+   Use the following ROCm tools to verify that the ROCm stack is correctly
+   installed and that your AMD GPU is visible to the system.
+
+   .. selected:: i=pip
+
+      1. Use ``hipinfo`` to list detected AMD GPUs and confirm that the ROCm
+         runtimes and drivers are correctly installed and loaded.
+
+         .. code-block:: bash
+
+            hipinfo
+
+         .. dropdown:: Example output of ``hipinfo``
+            :animate: fade-in-slide-down
+            :color: success
+            :icon: note
+            :chevron: down-up
+
+            .. code-block:: shell-session
+
+               --------------------------------------------------------------------------------
+               device#                           0
+               Name:                             AMD Radeon(TM) 8060S Graphics
+               pciBusID:                         197
+               pciDeviceID:                      0
+               pciDomainID:                      0
+               multiProcessorCount:              20
+
+               ... [output truncated]
+
+      2. Inspect your installation in your Python environment and confirm that
+         ROCm packages, including the ``rocm-sdk`` CLI, are available.
+
+         .. code-block:: bash
+
+            pip freeze
+            where rocm-sdk
+            dir .venv\Scripts
+
+   .. selected:: i=tar
+
+      Use ``hipinfo`` to list detected AMD GPUs and confirm that the ROCm
+      runtimes and drivers are correctly installed and loaded.
+
+      .. code-block:: bash
+
+         hipinfo
+
+      .. dropdown:: Example output of ``hipinfo``
+         :animate: fade-in-slide-down
+         :color: success
+         :icon: note
+         :chevron: down-up
+
+         .. code-block:: shell-session
+
+            --------------------------------------------------------------------------------
+            device#                           0
+            Name:                             AMD Radeon(TM) 8060S Graphics
+            pciBusID:                         197
+            pciDeviceID:                      0
+            pciDomainID:                      0
+            multiProcessorCount:              20
+
+            ... [output truncated]
+
+.. selected:: os=ubuntu os=rhel os=sles
+
+   .. selected:: i=pip
+      :heading: Test your installation
+      :heading-level: 3
+
+      Run the following commands from your Python virtual environment to confirm
+      that the ROCm SDK is correctly configured and that basic checks complete
+      successfully.
+
+      .. code-block:: bash
+
+         rocm-sdk targets
+         rocm-sdk path --cmake
+         rocm-sdk path --bin
+         rocm-sdk path --root
+
+      To learn more about the ``rocm-sdk`` tool and to see example expected
+      outputs, see `Using ROCm Python packages (TheRock)
+      <https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages>`__.
+
+   .. selected:: i=tar
+      :heading: Test your installation
+      :heading-level: 3
+
+      Run the ``test_hip_api`` tool to verify that the HIP runtime can access
+      your GPU and execute a simple workload.
+
+      .. code-block:: bash
+
+         test_hip_api
+
+.. selected:: os=windows
+
+   .. selected:: i=pip
+      :heading: Test your installation
+      :heading-level: 3
+
+      Run the following commands from your Python virtual environment to confirm
+      that the ROCm SDK is correctly configured and that basic checks complete
+      successfully.
+
+      .. code-block:: bash
+
+         rocm-sdk test
+
+      To learn more about the ``rocm-sdk`` tool and to see example expected
+      outputs, see `Using ROCm Python packages (TheRock)
+      <https://github.com/ROCm/TheRock/blob/main/RELEASES.md#using-rocm-python-packages>`__.
+
+.. selected:: i=pip
+
+   .. tip::
+
+      If you need to deactivate your Python virtual environment when finished, run:
+
+      .. code-block::
+
+         deactivate
+
--- a/docs/install/includes/prerequisites.rst
+++ b/docs/install/includes/prerequisites.rst
@@ -0,0 +1,301 @@
+Prerequisites
+=============
+
+Before installing the ROCm Core SDK |ROCM_VERSION|, ensure your system meets
+all prerequisites. This includes installing the required dependencies and
+configuring permissions for GPU access. To confirm that your system is
+supported, see the :doc:`Compatibility matrix
+</compatibility/compatibility-matrix>`.
+
+.. selected:: os=ubuntu os=rhel os=sles
+
+   .. dropdown:: Install essential packages for Docker containers
+      :animate: fade-in-slide-down
+      :color: info
+      :icon: tools
+      :chevron: down-up
+
+      Docker images often include only a minimal set of installations, so some
+      essential packages might be missing. When installing ROCm within a Docker
+      container, you might need to install additional packages for a successful
+      installation.
+
+      If applicable, run the following command to install essential packages:
+
+      .. selected:: os=ubuntu
+
+         .. code-block:: bash
+
+            apt update
+            apt install sudo wget python3 libatomic1
+
+      .. selected:: os=rhel
+
+         .. selected:: os-version=10.1 os-version=10.0 os-version=9.7 os-version=9.6
+
+            .. code-block:: bash
+
+               dnf install sudo wget libatomic
+
+         .. selected:: os-version=8
+
+            .. code-block:: bash
+
+               dnf install sudo wget libatomic python3
+
+      .. selected:: os=sles
+
+         .. code-block:: bash
+
+            zypper install sudo libatomic1 libgfortran5 wget SUSEConnect python3
+
+
+.. selected:: os=windows
+
+    1. Remove any existing HIP SDK for Windows installations and other
+       conflicting AMD graphics software.
+
+    2. Install the Adrenalin Driver for Windows.
+
+       * For general use cases, use the Adrenalin Driver version 25.11.1. For
+         details and the download link, see `AMD Software: Adrenalin
+         Edition 25.11.1
+         <https://www.amd.com/en/resources/support-articles/release-notes/RN-RAD-WIN-25-11-1.html>`__.
+
+       * If you intend to run :ref:`ComfyUI workloads
+         <install-comfyui-windows>`, use driver version 25.20.01.17. For
+         details and the download link, see `AMD Software: PyTorch on Windows
+         Edition 7.1.1
+         <https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__.
+
+    3. Disable the following Windows security features as they can interfere
+       with ROCm functionality:
+
+       * Turn off WDAG (Windows Defender Application Guard)
+
+         * Control Panel > Programs > Programs and Features > Turn Windows
+           features on or off > **Clear** “Microsoft Defender Application
+           Guard”
+
+       * Turn off SAC (Smart App Control)
+
+         * Settings > Privacy & security > Windows Security > App & browser
+           control > Smart App Control settings > **Off**
+
+.. selected:: os=rhel
+   :heading: Register your Red Hat Enterprise Linux system
+   :heading-level: 3
+
+   Register your Red Hat Enterprise Linux (RHEL) system to enable access to Red
+   Hat repositories and ensure you’re able to download and install packages.
+
+   Run the following command to register your system:
+
+   .. selected:: os-version=10.1 os-version=10.0
+
+      .. code-block:: bash
+
+         subscription-manager register --username <username> --password <password>
+
+   .. selected:: os-version=9.7 os-version=9.6 os-version=8
+
+      .. code-block:: bash
+
+         subscription-manager register --username <username> --password <password>
+         subscription-manager attach --auto
+
+.. selected:: os=sles
+   :heading: Register your SUSE Linux Enterprise Server system
+   :heading-level: 3
+
+   Register your SUSE Linux Enterprise Server (SLES) system to enable access to
+   SUSE repositories and ensure you’re able to download and install packages.
+
+   Run the following command to register your system:
+
+   .. code-block:: bash
+
+      sudo SUSEConnect -r <REGCODE>
+
+.. selected:: os=rhel
+   :heading: Update your system
+   :heading-level: 3
+
+   After registering your system, update RHEL to the latest packages. This is
+   particularly important for newer hardware on older versions of RHEL.
+
+   Run the following command to update your system:
+
+   .. selected:: os-version=10.1
+
+      .. code-block:: bash
+
+         sudo dnf update --releasever=10.1 --exclude=\*release\*
+
+   .. selected:: os-version=10.0
+
+      .. code-block:: bash
+
+         sudo dnf update --releasever=10.0 --exclude=\*release\*
+
+   .. selected:: os-version=9.7
+
+      .. code-block:: bash
+
+         sudo dnf update --releasever=9.7 --exclude=\*release\*
+
+   .. selected:: os-version=9.6
+
+      .. code-block:: bash
+
+         sudo dnf update --releasever=9.6 --exclude=\*release\*
+
+   .. selected:: os-version=8
+
+      .. code-block:: bash
+
+         sudo dnf update --releasever=8.10 --exclude=\*release\*
+
+.. selected:: os=sles
+   :heading: Update your system
+   :heading-level: 3
+
+   After registering your system, update SLES to the latest available packages.
+   This is particularly important for newer hardware on older versions of SLES.
+
+   Run the following command to update your system:
+
+   .. code-block:: bash
+
+      sudo zypper update
+
+.. selected:: i=pip
+
+   .. selected:: os=ubuntu
+
+      .. selected:: os-version=24
+         :heading: Install Python
+         :heading-level: 3
+
+         Install a supported Python version. For example, to install Python
+         3.12, run the following command:
+
+         .. code-block:: bash
+
+            sudo apt install python3.12 python3.12-venv
+
+      .. selected:: os-version=22
+         :heading: Install Python
+         :heading-level: 3
+
+         Install a supported Python version. For example, to install Python
+         3.11, run the following command:
+
+         .. code-block:: bash
+
+            sudo apt install python3.11 python3.11-venv
+
+   .. selected:: os=rhel
+
+      .. selected:: os-version=10.1 os-version=10.0
+         :heading: Install Python
+         :heading-level: 3
+
+         Install a supported Python version. For example, to install Python
+         3.12, run the following command:
+
+         .. code-block:: bash
+
+            sudo dnf install python3.12 python3.12-pip
+
+      .. selected:: os-version=9.7 os-version=9.6 os-version=8
+         :heading: Install Python
+         :heading-level: 3
+
+         Install a supported Python version. For example, to install Python
+         3.11, run the following command:
+
+         .. code-block:: bash
+
+            sudo dnf install python3.11 python3.11-pip
+
+   .. selected:: os=sles
+      :heading: Install Python
+      :heading-level: 3
+
+      Install a supported Python version. For example, to install Python 3.11,
+      run the following command:
+
+      .. code-block:: bash
+
+         sudo zypper install -y python311 python311-pip
+
+   .. selected:: os=windows
+      :heading: Install Python
+      :heading-level: 3
+
+      Install a supported Python version: 3.11, 3.12, or 3.13.
+
+.. selected:: os=rhel
+
+   .. selected:: os-version=10.0 os-version=8
+      :heading: Install additional development packages
+      :heading-level: 3
+
+      .. code-block:: bash
+
+         sudo dnf install libatomic
+
+.. selected:: os=sles
+
+   .. selected:: os-version=15
+      :heading: Install additional development packages
+      :heading-level: 3
+
+      .. code-block:: bash
+
+         sudo zypper install libatomic1
+
+.. selected:: os=ubuntu os=rhel os=sles
+   :heading: Configure permissions for GPU access
+   :heading-level: 3
+
+   There are two primary methods of configuring GPU access for ROCm: group
+   membership or udev rules. Each method has its own advantages. The choice
+   depends on your specific requirements and system management preferences.
+
+   .. tab-set::
+
+      .. tab-item:: Group membership
+
+         By default, GPU access is controlled by membership in the ``video`` and
+         ``render`` Linux system groups. The ``video`` group traditionally handles
+         video device access, while the ``render`` group manages GPU rendering
+         through DRM render nodes.
+
+         .. code-block:: bash
+
+            # Add the current user to the render and video groups
+            sudo usermod -a -G render,video $LOGNAME
+
+      .. tab-item:: udev rules
+
+         udev rules are a flexible, system-wide approach for managing device
+         permissions, eliminating the need for user group management while
+         allowing granular GPU access. To enable them and grant GPU access to
+         all users, run the following command:
+
+         .. code-block:: bash
+
+            sudo tee /etc/udev/rules.d/70-amdgpu.rules << EOF
+            KERNEL=="kfd", GROUP="render", MODE="0666"
+            SUBSYSTEM=="drm", KERNEL=="renderD*", GROUP="render", MODE="0666"
+            EOF
+
+            sudo udevadm control --reload-rules
+            sudo udevadm trigger
+
+   .. note::
+
+      To apply all settings, reboot your system.
+
--- a/docs/install/includes/selector.rst
+++ b/docs/install/includes/selector.rst
@@ -0,0 +1,73 @@
+.. include:: /compatibility/includes/selector.rst
+
+.. selected:: fam=instinct fam=radeon-pro fam=radeon
+
+   .. selector:: Ubuntu version
+      :key: os-version
+      :show-when: os=ubuntu
+
+      .. selector-option:: 24.04.3
+         :value: 24
+
+      .. selector-option:: 22.04.5
+         :value: 22
+
+.. selected:: fam=ryzen
+
+   .. selector:: Ubuntu version
+      :key: os-version
+      :show-when: os=ubuntu
+
+      .. selector-option:: 24.04.3
+         :value: 24
+         :width: 12
+
+.. selector:: RHEL version
+   :key: os-version
+   :show-when: os=rhel
+
+   .. selector-option:: 10.1
+      :value: 10.1
+      :width: 3
+
+   .. selector-option:: 10.0
+      :value: 10.0
+      :width: 3
+
+   .. selector-option:: 9.7
+      :value: 9.7
+      :width: 2
+
+   .. selector-option:: 9.6
+      :value: 9.6
+      :width: 2
+
+   .. selector-option:: 8.10
+      :value: 8
+      :width: 2
+
+.. selector:: SLES version
+   :key: os-version
+   :show-when: os=sles
+
+   .. selector-option:: 15.7
+      :value: 15
+      :width: 12
+
+.. selector:: Windows version
+   :key: os-version
+   :show-when: os=windows
+
+   .. selector-option:: 11 25H2
+      :value: 11-25h2
+      :width: 12
+
+.. selector:: Installation method
+   :key: i
+
+   .. selector-option:: pip
+      :value: pip
+
+   .. selector-option:: Tarball
+      :value: tar
+
--- a/docs/install/includes/uninstall.rst
+++ b/docs/install/includes/uninstall.rst
@@ -0,0 +1,102 @@
+Uninstalling
+============
+
+.. dropdown:: Installation environment
+   :animate: fade-in-slide-down
+   :icon: desktop-download
+   :chevron: down-up
+
+   .. include:: ./includes/selector.rst
+
+.. selected:: i=pip
+   :heading: Remove your Python virtual environment
+   :heading-level: 3
+
+   1. Clear the pip cache.
+
+      .. selected:: os=ubuntu os=rhel os=sles
+
+         .. code-block:: bash
+
+            sudo rm -rf ~/.cache/pip
+
+      .. selected:: os=windows
+
+         .. code-block:: bat
+
+            pip cache purge
+
+   2. Remove your local Python virtual environment.
+
+      .. selected:: os=ubuntu os=rhel os=sles
+
+         .. code-block:: bash
+
+            sudo rm -rf .venv
+
+      .. selected:: os=windows
+
+         .. code-block:: bat
+
+            rmdir /s /q .venv
+
+   .. selected:: os=windows
+
+.. selected:: i=tar
+   :heading: Remove your installation directory
+   :heading-level: 3
+
+   .. selected:: os=ubuntu os=rhel os=sles
+
+      1. To uninstall ROCm, remove your installation directory.
+
+         .. important::
+
+            The following command assumes you’re working with the
+            ``therock-tarball`` directory. If you chose a different directory
+            name when :ref:`installing ROCm <rocm-install>`, adjust the command
+            accordingly.
+
+         .. code-block:: bash
+
+            sudo rm -rf therock-tarball
+
+      2. If you opted for a :ref:`system-wide setup
+         <rocm-post-install-system-wide>` during the installation process,
+         remove the ROCm environment variables.
+
+         .. code-block:: bash
+
+            sudo rm -f /etc/profile.d/set-rocm-env.sh
+
+   .. selected:: os=windows
+
+      1. Delete your ``C:\TheRock\build`` installation directory and its
+         contents.
+
+         .. important::
+
+            This step assumes you’re working with the ``C:\TheRock\build``
+            directory. If you chose a different directory name when
+            :ref:`installing ROCm <rocm-install>`, adjust this step
+            accordingly.
+
+      2. Delete the environment variables. For example, using PowerShell as an administrator:
+
+         .. code-block:: powershell
+
+            [Environment]::SetEnvironmentVariable("HIP_PATH", $null, "Machine")
+            [Environment]::SetEnvironmentVariable("HIP_DEVICE_LIB_PATH", $null, "Machine")
+            [Environment]::SetEnvironmentVariable("HIP_PLATFORM", $null, "Machine")
+            [Environment]::SetEnvironmentVariable("LLVM_PATH", $null, "Machine")
+
+         Remove the following paths from your PATH environment variable using your system settings GUI.
+
+         * ``C:\TheRock\build\bin``
+
+         * ``C:\TheRock\build\lib\llvm\bin``
+
+      3. If you want to uninstall the Adrenalin driver, see `Uninstall AMD
+         Software
+         <https://www.amd.com/en/resources/support-articles/faqs/RSX2-UNINSTALL.html>`__.
+
--- a/docs/install/pytorch-comfyui.rst
+++ b/docs/install/pytorch-comfyui.rst
@@ -1,169 +0,0 @@
-.. meta::
-   :description: Step-by-step guide to installing PyTorch with AMD ROCm 7.9.0 and setting up ComfyUI for AI image generation on Ryzen AI (gfx1151) APUs. Covers Linux and Windows installation, environment setup, and troubleshooting.
-   :keywords: PyTorch ROCm, ComfyUI, ROCm 7.9.0, AMD GPU, Ryzen AI APU, install PyTorch ROCm, ROCm PyTorch Windows, ROCm PyTorch Linux, ROCm AI image generation, ROCm gfx1151, ComfyUI ROCm setup, PyTorch 2.9.0 ROCm
-
-*****************************************
-Install PyTorch and ComfyUI on ROCm 7.9.0
-*****************************************
-
-This guide walks you through installing PyTorch with ROCm support on AMD
-hardware. It applies to :ref:`supported AMD GPUs and platforms
-<790-supported-hw>`. It also includes additional setup steps for ComfyUI on
-Windows using Ryzen AI (gfx1151) APUs, showcasing AI-powered image generation.
-
-Prerequisites
-=============
-
-Before beginning, ensure your system meets these requirements:
-
- Python version: 3.11, 3.12, or 3.13 installed and accessible
-
- ROCm 7.9.0: A working ROCm installation (if not already installed via pip, this guide covers the setup)
-
-Review the :doc:`ROCm 7.9.0 compatibility <compatibility-matrix>` information.
-
-.. _790-install-pyt:
-
-Install PyTorch
-===============
-
-For prerequisite steps and post-installation recommendations, see :doc:`rocm`.
-
-1. Set up your Python virtual environment. If you already have a successful
-   :doc:`ROCm 7.9.0 installation via pip <rocm>`, skip this step.
-
-   .. code-block:: shell
-
-      python3.12 -m venv .venv
-
-2. Activate your Python virtual environment.
-
-   .. tab-set::
-
-      .. tab-item:: Linux
-         :sync: linux
-
-         .. code-block:: shell
-
-            source .venv/bin/activate
-
-      .. tab-item:: Windows
-         :sync: windows
-
-         .. code-block:: shell
-
-            .venv\Scripts\activate
-
-3. Install the appropriate ROCm-enabled PyTorch build for your operating system
-   and AMD hardware architecture.
-
-   .. tab-set::
-
-      .. tab-item:: Linux (PyTorch 2.7.1)
-         :sync: linux
-
-         .. tab-set::
-
-            .. tab-item:: Instinct MI350 Series
-               :sync: gfx950
-
-               .. code-block:: bash
-
-                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ torch torchvision torchaudio
-
-            .. tab-item:: Instinct MI300 Series
-               :sync: gfx942
-
-               .. code-block:: bash
-
-                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ torch torchvision torchaudio
-
-            .. tab-item:: Ryzen AI Max APU
-               :sync: gfx1151
-
-               .. code-block:: bash
-
-                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
-
-      .. tab-item:: Windows (PyTorch 2.9.0)
-         :sync: windows
-
-         .. tab-set::
-
-            .. tab-item:: Ryzen AI Max APU
-               :sync: gfx1151
-
-               .. code-block:: bash
-
-                  python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
-
-4. Check your PyTorch installation.
-
-   .. code-block:: shell
-
-      python -c "import torch; print(torch.cuda.is_available())"
-
-   This prints ``True`` if PyTorch and ROCm are installed properly.
-
-Optionally, if you're running Windows on a supported Ryzen AI APU, try
-:ref:`ComfyUI on Windows <790-install-comfyui>`.
-
-.. _790-install-comfyui:
-
-Install ComfyUI on Windows
-==========================
-
-ComfyUI is tested for support only on Ryzen AI (gfx1151) APUs on
-Windows.
-
-1. Ensure your working environment is running ROCm-enabled PyTorch 2.9.0 on Windows.
-   See :ref:`Install PyTorch <790-install-pyt>`.
-
-2. Clone the ComfyUI repository.
-
-   .. code-block:: shell
-
-      git clone https://github.com/comfyanonymous/ComfyUI.git
-
-3. Install Python dependencies.
-
-   .. code-block:: shell
-
-      pip install -r ComfyUI\requirements.txt
-
-4. Run ComfyUI.
-
-   a. Start the ComfyUI server from the command line.
-
-      .. code-block:: bash
-
-         python ComfyUI\main.py
-
-      This will start the server and display a prompt like:
-
-      .. code-block:: text
-
-         To see the GUI go to: http://127.0.0.1:8188
-
-   b. Navigate to ``http://127.0.0.1:8188`` in your web browser. You might need to
-      replace `8188` with the appropriate port number.
-
-      .. image:: /data/comfyui.png
-         :align: center
-
-   c. Search for the "Chroma1 Radiance text to image" template.
-
-      - Select **Template** → **Images** → **Chroma1_radiance**.
-      - Download any missing required models.
-
-      .. image:: /data/comfyui-missing-models.png
-         :align: center
-
-   d. Click the **Run** button.
-
-   The application will use your AMD GPU to convert the prompted text to an image.
-
-Known limitations
-----------------
-
-ComfyUI might not start if Smart App Control is enabled.
--- a/docs/install/redirect/_install.rst
+++ b/docs/install/redirect/_install.rst
@@ -0,0 +1,14 @@
+.. raw:: html
+
+   <meta http-equiv="refresh" content="0; url=../rocm.html#rocm-install">
+
+*******************************
+Install AMD ROCm |ROCM_VERSION|
+*******************************
+
+Redirecting...
+==============
+
+.. important::
+
+   If you're not redirected automatically, go to :ref:`rocm-install`.
--- a/docs/install/redirect/_post-install.rst
+++ b/docs/install/redirect/_post-install.rst
@@ -0,0 +1,14 @@
+.. raw:: html
+
+   <meta http-equiv="refresh" content="0; url=../rocm.html#post-install">
+
+*******************************
+Install AMD ROCm |ROCM_VERSION|
+*******************************
+
+Redirecting...
+==============
+
+.. important::
+
+   If you're not redirected automatically, go to :ref:`rocm-post-install`.
--- a/docs/install/redirect/_prerequisites.rst
+++ b/docs/install/redirect/_prerequisites.rst
@@ -0,0 +1,14 @@
+.. raw:: html
+
+   <meta http-equiv="refresh" content="0; url=../rocm.html#rocm-prerequisites">
+
+*******************************
+Install AMD ROCm |ROCM_VERSION|
+*******************************
+
+Redirecting...
+==============
+
+.. important::
+
+   If you're not redirected automatically, go to :ref:`rocm-prerequisites`.
--- a/docs/install/redirect/_uninstall.rst
+++ b/docs/install/redirect/_uninstall.rst
@@ -0,0 +1,14 @@
+.. raw:: html
+
+   <meta http-equiv="refresh" content="0; url=../rocm.html#rocm-uninstall">
+
+*******************************
+Install AMD ROCm |ROCM_VERSION|
+*******************************
+
+Redirecting...
+==============
+
+.. important::
+
+   If you're not redirected automatically, go to :ref:`rocm-uninstall`.
--- a/docs/install/rocm.rst
+++ b/docs/install/rocm.rst
@@ -1,441 +1,55 @@
 .. meta::
-   :description: Learn how to install AMD ROCm 7.9.0 for supported Instinct GPUs and Ryzen AI APUs on Ubuntu, RHEL, and Windows. This step-by-step guide covers prerequisites, driver setup, installation methods (pip and tarball), and troubleshooting.
-   :keywords: AMD ROCm 7.9.0, install ROCm, Instinct GPU, Ryzen APU, Ubuntu, RHEL, Windows, pip install ROCm, ROCm wheel, ROCm tarball, ROCm GPU driver, ROCm setup, ROCm uninstall, ROCm troubleshooting**********************
+   :description: Learn how to install AMD ROCm 7.10.0 for supported Instinct GPUs and Ryzen AI APUs on Ubuntu, RHEL, and Windows. This step-by-step guide covers prerequisites, driver setup, installation methods (pip and tarball), and troubleshooting.
+   :keywords: AMD ROCm 7.10.0, install ROCm, Instinct GPU, Ryzen APU, Ubuntu, RHEL, Windows, pip install ROCm, ROCm wheel, ROCm tarball, ROCm GPU driver, ROCm setup, ROCm uninstall, ROCm troubleshooting

-Install AMD ROCm 7.9.0
-**********************
+*******************************
+Install AMD ROCm |ROCM_VERSION|
+*******************************
+
+.. _rocm-install-selector:

 Use the following selector to choose your installation method for your
-supported AMD GPU or APU and operating system. For information about supported
-operating systems and compatible AMD devices, see the :doc:`Compatibility matrix
-<compatibility-matrix>`.
+supported AMD GPU or APU and operating system. For system requirements and
+support information, see the :doc:`Compatibility matrix
+</compatibility/compatibility-matrix>`. To learn more about changes introduced
+in ROCm |ROCM_VERSION|, see the :doc:`Release notes </about/release-notes>`.

-.. selector:: AMD product family
-   :key: plat
+.. include:: ./includes/selector.rst

-   .. selector-option:: Instinct GPU
-      :value: instinct
-      :width: 6
+----

-   .. selector-option:: Ryzen APU
-      :value: ryzen
-      :width: 6
+.. _rocm-prerequisites:

-.. selected:: plat=instinct
+.. include:: ./includes/prerequisites.rst

-   .. selector:: Instinct GPU
-      :key: instinct-arch
+----

-      .. selector-option:: Instinct MI355X, MI350X
-         :value: gfx950
+.. _rocm-install:

-      .. selector-option:: Instinct MI325X, MI300X, MI300A
-         :value: gfx942
+.. include:: ./includes/install.rst

-   .. selector:: Operating system
-      :key: instinct-os
+----

-      .. selector-option:: Ubuntu
-         :value: ubuntu
-         :icon: fab fa-linux fa-lg
+.. _rocm-post-install:

-      .. selector-option:: Red Hat Enterprise Linux
-         :value: rhel
-         :icon: fab fa-linux fa-lg
+.. include:: ./includes/post-install.rst

-   .. selector:: Ubuntu version
-      :key: instinct-ubuntu-version
-      :show-when: instinct-os=ubuntu
+----

-      .. selector-option:: 24.04.3
-         :value: 24.04
-         :icon: fab fa-ubuntu fa-lg
+.. _rocm-uninstall:

-      .. selector-option:: 22.04.5
-         :value: 22.04
-         :icon: fab fa-ubuntu fa-lg
+.. include:: ./includes/uninstall.rst

-   .. selector:: RHEL version
-      :key: instinct-rhel-version
-      :show-when: instinct-os=rhel
+|
+|
+|
+|
+|
+|
+|
+|
+|

-      .. selector-option:: 10.0
-         :value: 10.0
-         :icon: fab fa-redhat fa-lg
+.. raw:: html

-      .. selector-option:: 9.6
-         :value: 9.6
-         :icon: fab fa-redhat fa-lg
-
-.. selected:: plat=ryzen
-
-   .. selector:: Ryzen APU
-      :key: ryzen
-
-      .. selector-option:: Ryzen AI Max+ PRO 395, 390, 385, 380
-         :value: ryzen-ai-max-pro
-         :width: 7
-
-      .. selector-option:: Ryzen AI Max 395, 390, 385
-         :value: ryzen-ai-max
-         :width: 5
-
-   .. selector:: Operating system
-      :key: ryzen-os
-
-      .. selector-option:: Ubuntu
-         :value: ubuntu
-         :icon: fab fa-linux fa-lg
-
-      .. selector-option:: Windows
-         :value: windows
-         :icon: fab fa-windows fa-lg
-
-   .. selector:: Ubuntu version
-      :key: ryzen-ubuntu-version
-      :show-when: ryzen-os=ubuntu
-
-      .. selector-option:: 24.04.3
-         :value: 24.04
-         :icon: fab fa-ubuntu fa-lg
-         :width: 12
-
-   .. selector:: Windows version
-      :key: ryzen-windows-version
-      :show-when: ryzen-os=windows
-
-      .. selector-option:: 11 24H2
-         :value: 11_24h2
-         :icon: fab fa-windows fa-lg
-         :width: 12
-
-.. selector:: Installation method
-   :key: install-method
-
-   .. selector-option:: pip
-      :value: wheel
-
-   .. selector-option:: Tarball
-      :value: tar
-
-.. selected:: install-method=wheel
-   :heading: Prerequisites
-
-   .. selected:: plat=instinct
-
-      .. selected:: instinct-os=ubuntu
-
-         .. selected:: instinct-ubuntu-version=22.04
-
-            .. include:: ./includes/1_ubuntu-22.04-wheel-prerequisites.md
-               :parser: myst
-
-         .. selected:: instinct-ubuntu-version=24.04
-
-            .. include:: ./includes/1_ubuntu-24.04-wheel-prerequisites.md
-               :parser: myst
-
-      .. selected:: instinct-os=rhel
-
-         .. selected:: instinct-rhel-version=9.6
-
-            .. include:: ./includes/1_rhel-9.6-wheel-prerequisites.md
-               :parser: myst
-
-         .. selected:: instinct-rhel-version=10.0
-
-            .. include:: ./includes/1_rhel-10.0-wheel-prerequisites.md
-               :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. selected:: ryzen-ubuntu-version=24.04
-
-            .. include:: ./includes/1_ubuntu-24.04-wheel-prerequisites.md
-               :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/1_windows-wheel-prerequisites.md
-            :parser: myst
-
-.. selected:: install-method=tar
-   :heading: Prerequisites
-
-   .. selected:: plat=instinct
-
-      .. selected:: instinct-os=ubuntu
-
-         .. include:: ./includes/1_ubuntu-tar-prerequisites.md
-            :parser: myst
-
-      .. selected:: instinct-os=rhel
-
-         .. selected:: instinct-rhel-version=9.6
-
-            .. include:: ./includes/1_rhel-9.6-tar-prerequisites.md
-               :parser: myst
-
-         .. selected:: instinct-rhel-version=10.0
-
-            .. include:: ./includes/1_rhel-10.0-tar-prerequisites.md
-               :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/1_ubuntu-tar-prerequisites.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/1_windows-tar-prerequisites.md
-            :parser: myst
-
-.. selected:: plat=instinct
-   :heading: Installing
-
-   .. selected:: instinct-os=ubuntu
-      :heading: Install AMD GPU Driver
-      :heading-level: 3
-
-      .. include:: ./includes/2_ubuntu-instinct-install-kmd.md
-         :parser: myst
-
-   .. selected:: instinct-os=rhel
-      :heading: Install AMD GPU Driver
-      :heading-level: 3
-
-      .. include:: ./includes/2_rhel-instinct-install-kmd.md
-         :parser: myst
-
-.. selected:: plat=ryzen
-   :heading: Installing
-
-   .. selected:: ryzen-os=ubuntu
-      :heading: Install kernel driver
-      :heading-level: 3
-
-      Supported Ryzen AI APUs require the inbox kernel driver included with
-      Ubuntu 24.04.3.
-
-.. selected:: install-method=wheel
-   :heading: Install ROCm
-   :heading-level: 3
-
-   .. selected:: plat=instinct
-
-      .. selected:: instinct-arch=gfx950
-
-         .. selected:: instinct-os=ubuntu
-
-            .. selected:: instinct-ubuntu-version=22.04
-
-               .. include:: ./includes/3_wheel-gfx950-install-rocm-py311.md
-                  :parser: myst
-
-            .. selected:: instinct-ubuntu-version=24.04
-
-               .. include:: ./includes/3_wheel-gfx950-install-rocm.md
-                  :parser: myst
-
-         .. selected:: instinct-os=rhel
-
-            .. selected:: instinct-rhel-version=10.0
-
-               .. include:: ./includes/3_wheel-gfx950-install-rocm.md
-                  :parser: myst
-
-            .. selected:: instinct-rhel-version=9.6
-
-               .. include:: ./includes/3_wheel-gfx950-install-rocm-py311.md
-                  :parser: myst
-
-      .. selected:: instinct-arch=gfx942
-
-         .. selected:: instinct-os=ubuntu
-
-            .. selected:: instinct-ubuntu-version=22.04
-
-               .. include:: ./includes/3_wheel-gfx942-install-rocm-py311.md
-                  :parser: myst
-
-            .. selected:: instinct-ubuntu-version=24.04
-
-               .. include:: ./includes/3_wheel-gfx942-install-rocm.md
-                  :parser: myst
-
-         .. selected:: instinct-os=rhel
-
-            .. selected:: instinct-rhel-version=10.0
-
-               .. include:: ./includes/3_wheel-gfx942-install-rocm.md
-                  :parser: myst
-
-            .. selected:: instinct-rhel-version=9.6
-
-               .. include:: ./includes/3_wheel-gfx942-install-rocm-py311.md
-                  :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/3_wheel-gfx1151-install-rocm.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/3_windows-wheel-install-rocm.md
-            :parser: myst
-
-.. selected:: install-method=tar
-   :heading: Install ROCm
-   :heading-level: 3
-
-   .. selected:: plat=instinct
-
-      .. selected:: instinct-arch=gfx950
-
-         .. include:: ./includes/3_tar-gfx950-install-rocm.md
-            :parser: myst
-
-      .. selected:: instinct-arch=gfx942
-
-         .. include:: ./includes/3_tar-gfx942-install-rocm.md
-            :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/3_tar-gfx1151-install-rocm.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/3_windows-tar-install-rocm.md
-            :parser: myst
-
-.. selected:: install-method=tar
-   :heading: Post-installation
-
-   .. selected:: plat=instinct
-
-      .. include:: ./includes/4_linux-tar-post-install.md
-         :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/4_linux-tar-post-install.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/4_windows-tar-post-install.md
-            :parser: myst
-
-.. selected:: install-method=wheel
-   :heading: Post-installation
-
-   .. selected:: plat=instinct
-
-      .. selected:: instinct-os=ubuntu
-
-         .. include:: ./includes/4_ubuntu-wheel-post-install.md
-            :parser: myst
-
-      .. selected:: instinct-os=rhel
-
-         .. include:: ./includes/4_rhel-wheel-post-install.md
-            :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/4_ubuntu-wheel-post-install.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/4_windows-wheel-post-install.md
-            :parser: myst
-
-.. selected:: install-method=tar
-   :heading: Uninstalling
-
-   .. selected:: plat=instinct
-
-      .. include:: ./includes/5_tar-uninstall.md
-         :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/5_tar-uninstall.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/5_windows-tar-uninstall.md
-            :parser: myst
-
-.. selected:: install-method=wheel
-   :heading: Uninstalling
-
-   .. selected:: plat=instinct
-
-      .. include:: ./includes/5_wheel-linux-uninstall.md
-         :parser: myst
-
-   .. selected:: plat=ryzen
-
-      .. selected:: ryzen-os=ubuntu
-
-         .. include:: ./includes/5_wheel-linux-uninstall.md
-            :parser: myst
-
-      .. selected:: ryzen-os=windows
-
-         .. include:: ./includes/5_wheel-windows-uninstall.md
-            :parser: myst
-
-.. selected:: plat=instinct
-   :heading: Troubleshooting
-
-   .. selected:: instinct-os=ubuntu
-
-      .. selected:: instinct-os=ubuntu
-         :heading-level: 3
-         :heading: Additional packages for Docker installation
-
-         .. include:: ./includes/6_ubuntu-troubleshooting.md
-            :parser: myst
-
-   .. selected:: instinct-os=rhel
-
-      .. selected:: instinct-os=rhel
-         :heading-level: 3
-         :heading: Additional packages for Docker installation
-
-         .. include:: ./includes/6_rhel-troubleshooting.md
-            :parser: myst
-
-.. selected:: plat=ryzen
-
-   .. selected:: ryzen-os=ubuntu
-      :heading: Troubleshooting
-
-      .. selected:: ryzen-os=ubuntu
-         :heading-level: 3
-         :heading: Additional packages for Docker installation
-
-      .. include:: ./includes/6_ubuntu-troubleshooting.md
-         :parser: myst
+   <script src="../_static/next-button-install-page.js"></script>
--- a/docs/release/versions.md
+++ b/docs/release/versions.md
@@ -0,0 +1,28 @@
+<head>
+  <meta charset="UTF-8">
+  <meta name="description" content="ROCm preview release history">
+  <meta name="keywords" content="documentation, release history, ROCm, AMD">
+</head>
+
+# ROCm preview release history
+
+| Version | Release date |
+| ------- | ------------ |
+| [7.10.0](https://rocm.docs.amd.com/en/7.10.0-preview/) | December 11, 2025 |
+| [7.9.0](https://rocm.docs.amd.com/en/7.9.0-preview/) | October 20, 2025 |
+
+```{important}
+ROCm 7.9.0 introduced a versioning discontinuity following the previous [7.0
+releases](https://rocm.docs.amd.com/en/latest/release/versions.html). Versions
+7.0 through 7.8 are reserved for production stream ROCm releases, while
+versions 7.9.0 and later listed on this page represent the technology preview
+release stream. Both streams share a largely similar code base but differ in
+their build systems. These differences include the CMake configuration,
+operating system package dependencies, and the integration of AMD GPU Driver
+components.
+
+Maintaining parallel release streams -- preview and production -- gives users
+ample time to evaluate and adopt the new build system and dependency changes.
+The technology preview stream is planned to continue through mid‑2026, after
+which it will replace the current production stream.
+```
--- a/docs/rocm-for-ai/pytorch-comfyui.rst
+++ b/docs/rocm-for-ai/pytorch-comfyui.rst
@@ -0,0 +1,302 @@
+**************************************************
+Install PyTorch and ComfyUI on ROCm |ROCM_VERSION|
+**************************************************
+
+This topic guides you through installing PyTorch with ROCm support on AMD
+hardware. It applies to :ref:`supported AMD GPUs and platforms
+<release-supported-hw>`. It also includes additional setup steps for ComfyUI,
+showcasing AI-powered image generation.
+
+.. selector:: AMD device family
+   :key: fam
+
+   .. selector-option:: Instinct
+      :value: instinct
+      :width: 3
+
+   .. selector-option:: Radeon PRO
+      :value: radeon-pro
+      :width: 3
+
+   .. selector-option:: Radeon RX
+      :value: radeon
+      :width: 3
+
+   .. selector-option:: Ryzen AI
+      :value: ryzen
+      :width: 3
+
+.. selector:: Instinct GPU
+   :key: gfx
+   :show-when: fam=instinct
+
+   .. selector-info:: https://www.amd.com/en/products/accelerators/instinct.html
+
+   .. selector-option:: Instinct MI355X<br>Instinct MI350X
+      :value: 950
+      :width: 4
+
+   .. selector-option:: Instinct MI325X<br>Instinct MI300X<br>Instinct MI300A
+      :value: 942
+      :width: 4
+
+   .. selector-option:: Instinct MI250X<br>Instinct MI250<br>Instinct MI210
+      :value: 90a
+      :width: 4
+
+.. selector:: Radeon PRO GPU
+   :key: gfx
+   :show-when: fam=radeon-pro
+
+   .. selector-info:: https://www.amd.com/en/products/graphics/workstations.html
+
+   .. selector-option:: Radeon PRO W7900D<br>Radeon PRO W7900<br>Radeon PRO W7800 48GB<br>Radeon PRO W7800
+      :value: 1100
+      :width: 6
+
+   .. selector-option:: Radeon PRO W7700
+      :value: 1101
+      :width: 6
+
+.. selector:: Radeon RX GPU
+   :key: gfx
+   :show-when: fam=radeon
+
+   .. selector-info:: https://www.amd.com/en/products/graphics/desktops/radeon.html
+
+   .. selector-option:: Radeon RX 7900 XTX<br>Radeon RX 7900 XT<br>Radeon RX 7900 GRE
+      :value: 1100
+
+   .. selector-option:: Radeon RX 7800 XT<br>Radeon RX 7700 XT
+      :value: 1101
+
+.. selector:: Ryzen AI APU
+   :key: gfx
+   :show-when: fam=ryzen
+
+   .. selector-info:: https://www.amd.com/en/products/processors/workstations/mobile.html
+
+   .. selector-option:: Ryzen AI Max+ PRO 395<br>Ryzen AI Max PRO 390, 385, 380<br>Ryzen AI Max+ 395<br>Ryzen AI Max 390, 385
+      :value: 1151
+      :width: 7
+
+   .. selector-option:: Ryzen AI 9 HX 375<br>Ryzen AI 9 HX 370<br>Ryzen AI 9 365
+      :value: 1150
+      :width: 5
+
+.. selector:: Operating system
+   :key: os
+   :show-when: fam=instinct
+
+   .. selector-option:: Linux
+      :value: linux
+      :icon: fab fa-linux fa-lg
+      :width: 12
+
+.. selector:: Operating system
+   :key: os
+   :show-when: fam=radeon-pro fam=radeon fam=ryzen
+
+   .. selector-option:: Linux
+      :value: linux
+      :icon: fab fa-linux fa-lg
+      :width: 6
+
+   .. selector-option:: Windows
+      :value: windows
+      :icon: fab fa-windows fa-lg
+      :width: 6
+      :disable-when: fam=instinct
+
+Prerequisites
+=============
+
+.. selected:: os=windows
+
+   To run ComfyUI workloads on Windows, ensure you have Adrenalin Driver
+   version 25.20.01.17. For details and the download link, see `AMD Software:
+   PyTorch on Windows Edition 7.1.1
+   <https://www.amd.com/en/resources/support-articles/release-notes/RN-AMDGPU-WINDOWS-PYTORCH-7-1-1.html>`__. See the :ref:`related known issue <comfyui-driver-known-issue>`.
+
+Ensure your system has a :ref:`supported Python version
+<rocm-compat-python>` installed and accessible: 3.11, 3.12, or 3.13.
+
+Review the :doc:`/compatibility/compatibility-matrix` for more details.
+
+.. _pip-install-pytorch:
+
+Install PyTorch
+===============
+
+For prerequisite steps and post-installation recommendations, see the
+:doc:`ROCm installation instructions </install/rocm>`.
+
+1. Set up your Python virtual environment. If you already have a successful
+   :doc:`ROCm 7.10.0 installation using pip </install/rocm>`, skip this step.
+
+   For example, run the following command to create a virtual environment:
+
+   .. code-block:: shell
+
+      python3.12 -m venv .venv
+
+2. Activate your Python virtual environment. For example:
+
+   .. selected:: os=linux
+
+      .. code-block:: shell
+
+         source .venv/bin/activate
+
+   .. selected:: os=windows
+
+      .. code-block:: shell
+
+         .venv\Scripts\activate
+
+3. Install the appropriate ROCm-enabled PyTorch build for your operating system
+   and AMD hardware architecture.
+
+   .. selected:: gfx=950
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx950-dcgpu/ torch torchvision torchaudio
+
+   .. selected:: gfx=942
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx94X-dcgpu/ torch torchvision torchaudio
+
+   .. selected:: gfx=90a
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx90X-dcgpu/ torch torchvision torchaudio
+
+   .. selected:: gfx=1151
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1151/ torch torchvision torchaudio
+
+   .. selected:: gfx=1150
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx1150/ torch torchvision torchaudio
+
+   .. selected:: gfx=1100 gfx=1101
+
+      .. code-block:: bash
+
+         python -m pip install --index-url https://repo.amd.com/rocm/whl/gfx110X-dgpu/ torch torchvision torchaudio
+
+4. Check your PyTorch installation.
+
+   .. code-block:: shell
+
+      python -c "import torch; print(torch.cuda.is_available())"
+
+   This prints ``True`` if PyTorch and ROCm are installed properly.
+
+Optionally, for a demonstration of ROCm-powered image generation, try
+:ref:`ComfyUI on Windows <install-comfyui-windows>`.
+
+.. _install-comfyui-windows:
+
+Install and run ComfyUI
+=======================
+
+1. Ensure your working environment is running ROCm-enabled PyTorch on a supported system.
+   See :ref:`Install PyTorch <pip-install-pytorch>` for instructions.
+
+2. Clone the ComfyUI repository.
+
+   .. code-block:: shell
+
+      git clone https://github.com/comfyanonymous/ComfyUI.git
+
+3. Install Python dependencies.
+
+   .. selected:: os=linux
+
+      .. code-block:: shell
+
+         pip install -r ComfyUI/requirements.txt
+
+   .. selected:: os=windows
+
+      .. code-block:: shell
+
+         pip install -r ComfyUI\requirements.txt
+
+4. Run ComfyUI.
+
+   a. Start the ComfyUI server from the command line.
+
+      .. selected:: os=linux
+
+         .. code-block:: bash
+
+            python ComfyUI/main.py
+
+      .. selected:: os=windows
+
+         .. code-block:: bash
+
+            python ComfyUI\main.py
+
+      This will start the server and display a prompt like:
+
+      .. code-block:: text
+
+         To see the GUI go to: http://127.0.0.1:8188
+
+   b. Navigate to ``http://127.0.0.1:8188`` in your web browser. You might need to
+      replace ``8188`` with the appropriate port number.
+
+      .. image:: /data/comfyui/comfyui-main.png
+         :align: center
+
+   c. Search for one of the following templates and download any missing
+      models.
+
+      .. tab-set::
+
+         .. tab-item:: SD3.5 Simple
+
+            Select **Template** → **Model Filter** → **SD3.5** → **SD3.5 Simple**
+
+            .. image:: /data/comfyui/sd3_5-simple-card.png
+               :align: center
+
+            Download required models, if missing.
+
+            .. image:: /data/comfyui/sd3_5-missing-models.png
+               :align: center
+
+         .. tab-item:: Chroma1 Radiance text to image
+
+            Select **Template** → **Model Filter** → **Chroma** → **Chroma1 Radiance text to image**
+
+            .. image:: /data/comfyui/chroma1-radiance-tti-card.png
+               :align: center
+
+            Download required models, if missing.
+
+            .. image:: /data/comfyui/chroma1-radiance-tti-missing-models.png
+               :align: center
+
+   d. Click the **Run** button.
+
+   The application will use your AMD GPU to convert the prompted text to an image.
+
+.. selected:: os=windows
+   :heading: Known limitations
+   :heading-level: 3
+
+   ComfyUI might not start if Smart App Control is enabled in your Windows
+   security settings.
+
--- a/docs/sphinx/_toc.yml.in
+++ b/docs/sphinx/_toc.yml.in
@@ -3,230 +3,30 @@
 defaults:
  numbered: False
  maxdepth: 6
-root: index
+root: index.rst
 subtrees:
  - entries:
      - file: about/release-notes.md
        title: Release notes
-      - file: install/compatibility-matrix.md
+      - file: compatibility/compatibility-matrix.rst
        title: Compatibility matrix
-  - caption: Installation
+  - caption: Install
    entries:
-      - file: install/rocm
-        title: Installation
-      - url: https://github.com/ROCm/TheRock
+      - file: install/rocm.rst
+        title: Install ROCm
+        entries:
+          # Dummy entries to point to install doc sections
+          - file: install/redirect/_prerequisites.rst
+            title: Prerequisites
+          - file: install/redirect/_install.rst
+            title: Installation
+          - file: install/redirect/_post-install.rst
+            title: Post-installation
+      - file: install/redirect/_uninstall.rst
+        title: Uninstall ROCm
+      - file: install/build-from-source.rst
        title: Build from source
  - caption: ROCm for AI
    entries:
-      - file: install/pytorch-comfyui
+      - file: rocm-for-ai/pytorch-comfyui.rst
        title: Install PyTorch and ComfyUI
-      # - url: https://rocm.docs.amd.com/projects/install-on-linux/en/${branch}/
-      #   title: ROCm on Linux
-      # - url: https://rocm.docs.amd.com/projects/install-on-windows/en/latest/
-      #   title: HIP SDK on Windows
-      # - url: https://rocm.docs.amd.com/projects/radeon-ryzen/en/latest/index.html
-      #   title: ROCm on Radeon and Ryzen
-      # - file: how-to/deep-learning-rocm.md
-      #   title: Deep learning frameworks
-      #   subtrees:
-      #     - entries:
-      #         - file: compatibility/ml-compatibility/pytorch-compatibility.rst
-      #           title: PyTorch compatibility
-      #         - file: compatibility/ml-compatibility/tensorflow-compatibility.rst
-      #           title: TensorFlow compatibility
-      #         - file: compatibility/ml-compatibility/jax-compatibility.rst
-      #           title: JAX compatibility
-      #         - file: compatibility/ml-compatibility/verl-compatibility.rst
-      #           title: verl compatibility
-      #         - file: compatibility/ml-compatibility/stanford-megatron-lm-compatibility.rst
-      #           title: Stanford Megatron-LM compatibility
-      #         - file: compatibility/ml-compatibility/dgl-compatibility.rst
-      #           title: DGL compatibility
-      #         - file: compatibility/ml-compatibility/megablocks-compatibility.rst
-      #           title: Megablocks compatibility
-      #         - file: compatibility/ml-compatibility/taichi-compatibility.rst
-      #           title: Taichi compatibility
-      #         - file: compatibility/ml-compatibility/ray-compatibility.rst
-      #           title: Ray compatibility
-      #         - file: compatibility/ml-compatibility/llama-cpp-compatibility.rst
-      #           title: llama.cpp compatibility
-      #         - file: compatibility/ml-compatibility/flashinfer-compatibility.rst
-      #           title: FlashInfer compatibility
-
-  # - caption: How to
-  #   entries:
-  #     - file: how-to/rocm-for-ai/index.rst
-  #       title: Use ROCm for AI
-  #       subtrees:
-  #         - entries:
-  #             - file: how-to/rocm-for-ai/install.rst
-  #               title: Installation
-  #             - file: how-to/rocm-for-ai/system-setup/index.rst
-  #               title: System setup
-  #               entries:
-  #                 - file: how-to/rocm-for-ai/system-setup/prerequisite-system-validation.rst
-  #                   title: System validation
-  #                 - file: how-to/rocm-for-ai/system-setup/multi-node-setup.rst
-  #                   title: Multi-node setup
-  #                 - file: how-to/rocm-for-ai/system-setup/system-health-check.rst
-  #                   title: System health benchmarks
-  #             - file: how-to/rocm-for-ai/training/index.rst
-  #               title: Training
-  #               subtrees:
-  #                 - entries:
-  #                     - file: how-to/rocm-for-ai/training/benchmark-docker/primus-megatron.rst
-  #                       title: Train a model with Primus and Megatron-LM
-  #                     - file: how-to/rocm-for-ai/training/benchmark-docker/primus-pytorch.rst
-  #                       title: Train a model with Primus and 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
-  #                       title: Train a model with LLM Foundry
-  #                     - file: how-to/rocm-for-ai/training/scale-model-training.rst
-  #                       title: Scale model training
-  #
-  #             - file: how-to/rocm-for-ai/fine-tuning/index.rst
-  #               title: Fine-tuning LLMs
-  #               subtrees:
-  #                 - entries:
-  #                     - file: how-to/rocm-for-ai/fine-tuning/overview.rst
-  #                       title: Conceptual overview
-  #                     - file: how-to/rocm-for-ai/fine-tuning/fine-tuning-and-inference.rst
-  #                       title: Fine-tuning
-  #                       subtrees:
-  #                         - entries:
-  #                             - file: how-to/rocm-for-ai/fine-tuning/single-gpu-fine-tuning-and-inference.rst
-  #                               title: Use a single accelerator
-  #                             - file: how-to/rocm-for-ai/fine-tuning/multi-gpu-fine-tuning-and-inference.rst
-  #                               title: Use multiple accelerators
-  #
-  #             - file: how-to/rocm-for-ai/inference/index.rst
-  #               title: Inference
-  #               subtrees:
-  #                 - entries:
-  #                     - file: how-to/rocm-for-ai/inference/hugging-face-models.rst
-  #                       title: Run models from Hugging Face
-  #                     - file: how-to/rocm-for-ai/inference/llm-inference-frameworks.rst
-  #                       title: LLM inference frameworks
-  #                     - file: how-to/rocm-for-ai/inference/benchmark-docker/vllm.rst
-  #                       title: vLLM inference performance testing
-  #                     - file: how-to/rocm-for-ai/inference/benchmark-docker/pytorch-inference.rst
-  #                       title: PyTorch inference performance testing
-  #                     - file: how-to/rocm-for-ai/inference/benchmark-docker/sglang.rst
-  #                       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/deploy-your-model.rst
-  #                       title: Deploy your model
-  #
-  #             - file: how-to/rocm-for-ai/inference-optimization/index.rst
-  #               title: Inference optimization
-  #               subtrees:
-  #                 - entries:
-  #                     - file: how-to/rocm-for-ai/inference-optimization/model-quantization.rst
-  #                     - file: how-to/rocm-for-ai/inference-optimization/model-acceleration-libraries.rst
-  #                     - file: how-to/rocm-for-ai/inference-optimization/optimizing-with-composable-kernel.md
-  #                       title: Optimize with Composable Kernel
-  #                     - file: how-to/rocm-for-ai/inference-optimization/optimizing-triton-kernel.rst
-  #                       title: Optimize Triton kernels
-  #                     - file: how-to/rocm-for-ai/inference-optimization/profiling-and-debugging.rst
-  #                       title: Profile and debug
-  #                     - file: how-to/rocm-for-ai/inference-optimization/workload.rst
-  #                       title: Workload optimization
-  #
-  #             - url: https://rocm.docs.amd.com/projects/ai-developer-hub/en/latest/
-  #               title: AI tutorials
-  #
-  #     - file: how-to/rocm-for-hpc/index.rst
-  #       title: Use ROCm for HPC
-  #     - file: how-to/system-optimization/index.rst
-  #       title: System optimization
-  #     - file: how-to/gpu-performance/mi300x.rst
-  #       title: AMD Instinct MI300X performance guides
-  #     - file: how-to/system-debugging.md
-  #     - file: conceptual/compiler-topics.md
-  #       title: Use advanced compiler features
-  #       subtrees:
-  #         - entries:
-  #             - url: https://rocm.docs.amd.com/projects/llvm-project/en/latest/index.html
-  #               title: ROCm compiler infrastructure
-  #             - url: https://rocm.docs.amd.com/projects/llvm-project/en/latest/conceptual/using-gpu-sanitizer.html
-  #               title: Use AddressSanitizer
-  #             - url: https://rocm.docs.amd.com/projects/llvm-project/en/latest/conceptual/openmp.html
-  #               title: OpenMP support
-  #     - file: how-to/setting-cus
-  #       title: Set the number of CUs
-  #     - file: how-to/Bar-Memory.rst
-  #       title: Troubleshoot BAR access limitation
-  #     - url: https://github.com/amd/rocm-examples
-  #       title: ROCm examples
-  #
-  # - caption: Conceptual
-  #   entries:
-  #     - file: conceptual/gpu-arch.md
-  #       title: GPU architecture overview
-  #       subtrees:
-  #         - entries:
-  #             - file: conceptual/gpu-arch/mi300.md
-  #               title: MI300 microarchitecture
-  #               subtrees:
-  #                 - entries:
-  #                     - url: https://www.amd.com/content/dam/amd/en/documents/instinct-tech-docs/instruction-set-architectures/amd-instinct-mi300-cdna3-instruction-set-architecture.pdf
-  #                       title: AMD Instinct MI300/CDNA3 ISA
-  #                     - url: https://www.amd.com/content/dam/amd/en/documents/instinct-tech-docs/white-papers/amd-cdna-3-white-paper.pdf
-  #                       title: White paper
-  #                     - 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
-  #             - file: conceptual/gpu-arch/mi250.md
-  #               title: MI250 microarchitecture
-  #               subtrees:
-  #                 - entries:
-  #                     - url: https://www.amd.com/system/files/TechDocs/instinct-mi200-cdna2-instruction-set-architecture.pdf
-  #                       title: AMD Instinct MI200/CDNA2 ISA
-  #                     - url: https://www.amd.com/content/dam/amd/en/documents/instinct-business-docs/white-papers/amd-cdna2-white-paper.pdf
-  #                       title: White paper
-  #             - file: conceptual/gpu-arch/mi100.md
-  #               title: MI100 microarchitecture
-  #               subtrees:
-  #                 - entries:
-  #                     - url: https://www.amd.com/system/files/TechDocs/instinct-mi100-cdna1-shader-instruction-set-architecture%C2%A0.pdf
-  #                       title: AMD Instinct MI100/CDNA1 ISA
-  #                     - url: https://www.amd.com/content/dam/amd/en/documents/instinct-business-docs/white-papers/amd-cdna-white-paper.pdf
-  #                       title: White paper
-  #     - file: conceptual/file-reorg.md
-  #       title: File structure (Linux FHS)
-  #     - file: conceptual/gpu-isolation.md
-  #       title: GPU isolation techniques
-  #     - file: conceptual/cmake-packages.rst
-  #       title: Using CMake
-  #     - file: conceptual/ai-pytorch-inception.md
-  #       title: Inception v3 with PyTorch
-  #
-  # - caption: Reference
-  #   entries:
-  #     - file: reference/api-libraries.md
-  #       title: ROCm libraries
-  #     - file: reference/rocm-tools.md
-  #       title: ROCm tools, compilers, and runtimes
-  #     - file: reference/gpu-arch-specs.rst
-  #     - file: reference/gpu-atomics-operation.rst
-  #     - file: reference/precision-support.rst
-  #       title: Data types and precision support
-  #     - file: reference/graph-safe-support.rst
-  #       title: Graph safe support
-
-  # - caption: Contribute
-  #   entries:
-  #     - file: contribute/contributing.md
-  #       title: Contributing to the ROCm documentation
-  #       subtrees:
-  #         - entries:
-  #             - file: contribute/toolchain.md
-  #               title: ROCm documentation toolchain
-  #             - file: contribute/building.md
-  #     - file: contribute/feedback.md
-  #       title: Providing feedback about the ROCm documentation
-  #     - file: about/license.md
-  #       title: ROCm licenses
--- a/docs/sphinx/requirements.in
+++ b/docs/sphinx/requirements.in
@@ -1,4 +1,2 @@
-rocm-docs-core==1.26.0
-sphinx-reredirects
+rocm-docs-core==1.31.0
 sphinx-sitemap
-sphinxcontrib.datatemplates==0.11.0
--- a/docs/sphinx/requirements.txt
+++ b/docs/sphinx/requirements.txt
@@ -2,13 +2,13 @@
 # This file is autogenerated by pip-compile with Python 3.10
 # by the following command:
 #
-#    pip-compile docs/sphinx/requirements.in
+#    pip-compile --cert=None --client-cert=None --index-url=None --pip-args=None docs/sphinx/requirements.in
 #
 accessible-pygments==0.0.5
    # via pydata-sphinx-theme
 alabaster==1.0.0
    # via sphinx
-asttokens==3.0.0
+asttokens==3.0.1
    # via stack-data
 attrs==25.4.0
    # via
@@ -19,38 +19,36 @@ babel==2.17.0
    # via
    #   pydata-sphinx-theme
    #   sphinx
-beautifulsoup4==4.14.2
+beautifulsoup4==4.14.3
    # via pydata-sphinx-theme
 breathe==4.36.0
    # via rocm-docs-core
-certifi==2025.10.5
+certifi==2025.11.12
    # via requests
 cffi==2.0.0
    # via
    #   cryptography
    #   pynacl
-charset-normalizer==3.4.3
+charset-normalizer==3.4.4
    # via requests
-click==8.3.0
+click==8.3.1
    # via
    #   jupyter-cache
    #   sphinx-external-toc
 comm==0.2.3
    # via ipykernel
-cryptography==46.0.2
+cryptography==46.0.3
    # via pyjwt
 debugpy==1.8.17
    # via ipykernel
 decorator==5.2.1
    # via ipython
-defusedxml==0.7.1
-    # via sphinxcontrib-datatemplates
 docutils==0.21.2
    # via
    #   myst-parser
    #   pydata-sphinx-theme
    #   sphinx
-exceptiongroup==1.3.0
+exceptiongroup==1.3.1
    # via ipython
 executing==2.2.1
    # via stack-data
@@ -62,9 +60,9 @@ gitdb==4.0.12
    # via gitpython
 gitpython==3.1.45
    # via rocm-docs-core
-greenlet==3.2.4
+greenlet==3.3.0
    # via sqlalchemy
-idna==3.10
+idna==3.11
    # via requests
 imagesize==1.4.1
    # via sphinx
@@ -72,7 +70,7 @@ importlib-metadata==8.7.0
    # via
    #   jupyter-cache
    #   myst-nb
-ipykernel==6.30.1
+ipykernel==7.1.0
    # via myst-nb
 ipython==8.37.0
    # via
@@ -94,7 +92,7 @@ jupyter-client==8.6.3
    # via
    #   ipykernel
    #   nbclient
-jupyter-core==5.8.1
+jupyter-core==5.9.1
    # via
    #   ipykernel
    #   jupyter-client
@@ -106,7 +104,7 @@ markdown-it-py==3.0.0
    #   myst-parser
 markupsafe==3.0.3
    # via jinja2
-matplotlib-inline==0.1.7
+matplotlib-inline==0.2.1
    # via
    #   ipykernel
    #   ipython
@@ -132,16 +130,17 @@ nest-asyncio==1.6.0
 packaging==25.0
    # via
    #   ipykernel
+    #   pydata-sphinx-theme
    #   sphinx
 parso==0.8.5
    # via jedi
 pexpect==4.9.0
    # via ipython
-platformdirs==4.4.0
+platformdirs==4.5.1
    # via jupyter-core
 prompt-toolkit==3.0.52
    # via ipython
-psutil==7.1.0
+psutil==7.1.3
    # via ipykernel
 ptyprocess==0.7.0
    # via pexpect
@@ -149,7 +148,7 @@ pure-eval==0.2.3
    # via stack-data
 pycparser==2.23
    # via cffi
-pydata-sphinx-theme==0.16.1
+pydata-sphinx-theme==0.15.4
    # via
    #   rocm-docs-core
    #   sphinx-book-theme
@@ -163,7 +162,7 @@ pygments==2.19.2
    #   sphinx
 pyjwt[crypto]==2.10.1
    # via pygithub
-pynacl==1.6.0
+pynacl==1.6.1
    # via pygithub
 python-dateutil==2.9.0.post0
    # via jupyter-client
@@ -174,12 +173,11 @@ pyyaml==6.0.3
    #   myst-parser
    #   rocm-docs-core
    #   sphinx-external-toc
-    #   sphinxcontrib-datatemplates
 pyzmq==27.1.0
    # via
    #   ipykernel
    #   jupyter-client
-referencing==0.36.2
+referencing==0.37.0
    # via
    #   jsonschema
    #   jsonschema-specifications
@@ -187,9 +185,9 @@ requests==2.32.5
    # via
    #   pygithub
    #   sphinx
-rocm-docs-core==1.26.0
+rocm-docs-core==1.31.0
    # via -r docs/sphinx/requirements.in
-rpds-py==0.27.1
+rpds-py==0.30.0
    # via
    #   jsonschema
    #   referencing
@@ -214,10 +212,7 @@ sphinx==8.1.3
    #   sphinx-external-toc
    #   sphinx-last-updated-by-git
    #   sphinx-notfound-page
-    #   sphinx-reredirects
-    #   sphinxcontrib-datatemplates
-    #   sphinxcontrib-runcmd
-sphinx-book-theme==1.1.3
+sphinx-book-theme==1.1.4
    # via rocm-docs-core
 sphinx-copybutton==0.5.2
    # via rocm-docs-core
@@ -229,14 +224,10 @@ sphinx-last-updated-by-git==0.3.8
    # via sphinx-sitemap
 sphinx-notfound-page==1.1.0
    # via rocm-docs-core
-sphinx-reredirects==0.1.6
-    # via -r docs/sphinx/requirements.in
 sphinx-sitemap==2.9.0
    # via -r docs/sphinx/requirements.in
 sphinxcontrib-applehelp==2.0.0
    # via sphinx
-sphinxcontrib-datatemplates==0.11.0
-    # via -r docs/sphinx/requirements.in
 sphinxcontrib-devhelp==2.0.0
    # via sphinx
 sphinxcontrib-htmlhelp==2.1.0
@@ -245,17 +236,15 @@ sphinxcontrib-jsmath==1.0.1
    # via sphinx
 sphinxcontrib-qthelp==2.0.0
    # via sphinx
-sphinxcontrib-runcmd==0.2.0
-    # via sphinxcontrib-datatemplates
 sphinxcontrib-serializinghtml==2.0.0
    # via sphinx
-sqlalchemy==2.0.43
+sqlalchemy==2.0.44
    # via jupyter-cache
 stack-data==0.6.3
    # via ipython
 tabulate==0.9.0
    # via jupyter-cache
-tomli==2.2.1
+tomli==2.3.0
    # via sphinx
 tornado==6.5.2
    # via
@@ -281,7 +270,7 @@ typing-extensions==4.15.0
    #   pygithub
    #   referencing
    #   sqlalchemy
-urllib3==2.5.0
+urllib3==2.6.1
    # via
    #   pygithub
    #   requests
--- a/docs/sphinx/static/css/rocm_custom.css
+++ b/docs/sphinx/static/css/rocm_custom.css
@@ -1,16 +0,0 @@
-/* Override PyData Sphinx Theme default colors */
-html[data-theme="light"] {
-  --pst-color-table-row-hover-bg: #e2e8f0;
-}
-
-html[data-theme="dark"] {
-  --pst-color-table-row-hover-bg: #1e293b;
-}
-
-a svg {
-  color: var(--pst-color-text-base);
-}
-
-a svg:hover {
-  color: var(--pst-color-link-hover);
-}
--- a/docs/sphinx/static/css/rocm_rn.css
+++ b/docs/sphinx/static/css/rocm_rn.css
@@ -1,268 +0,0 @@
-#rocm-rn-components col {
-  width: 6rem;
-}
-#rocm-rn-components col:nth-child(2) {
-  width: 12rem;
-}
-#rocm-rn-components td {
-  white-space: nowrap;
-}
-#rocm-rn-components td:last-of-type {
-  text-align: center;
-}
-#rocm-rn-components a svg {
-  color: var(--pst-color-text-base);
-}
-#rocm-rn-components a svg:hover {
-  color: var(--pst-color-link-hover);
-}
-#rocm-rn-components .tbody-reverse-zebra tr:nth-child(2n+1) td {
-  background-color: var(--pst-color-table-row-zebra-high-bg);
-}
-#rocm-rn-components .tbody-reverse-zebra tr:nth-child(2n) td {
-  background-color: var(--pst-color-table-row-zebra-low-bg);
-}
-
-#rocm-rn-components:has(
-  tbody.rocm-components-libs th[rowspan]:first-of-type:hover
-)
-  .rocm-components-libs,
-#rocm-rn-components:has(
-  tbody.rocm-components-libs th[rowspan]:first-of-type:hover
-)
-  .rocm-components-libs
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-libs th[rowspan]:first-of-type:hover
-)
-  tbody.rocm-components-libs
-  th {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-tools th[rowspan]:first-of-type:hover
-)
-  .rocm-components-tools,
-#rocm-rn-components:has(
-  tbody.rocm-components-tools th[rowspan]:first-of-type:hover
-)
-  .rocm-components-tools
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-tools th[rowspan]:first-of-type:hover
-)
-  tbody.rocm-components-tools
-  th {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-compilers th[rowspan]:first-of-type:hover
-)
-  .rocm-components-compilers,
-#rocm-rn-components:has(
-  tbody.rocm-components-compilers th[rowspan]:first-of-type:hover
-)
-  .rocm-components-compilers
-  td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-runtimes th[rowspan]:first-of-type:hover
-)
-  .rocm-components-runtimes,
-#rocm-rn-components:has(
-  tbody.rocm-components-runtimes th[rowspan]:first-of-type:hover
-)
-  .rocm-components-runtimes
-  td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-
-#rocm-rn-components:has(
-  tbody.rocm-components-tools th[rowspan]:first-of-type:hover
-)
-  .rocm-components-tools
-  td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-compilers th[rowspan]:first-of-type:hover
-)
-  .rocm-components-compilers
-  td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-runtimes th[rowspan]:first-of-type:hover
-)
-  .rocm-components-runtimes
-  td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-
-#rocm-rn-components:has(
-  tbody.rocm-components-ml th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-ml
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-ml th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-libs
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-communication th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-communication
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-communication th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-libs
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-math th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-math
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-math th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-libs
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-primitives th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-primitives
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-primitives th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-libs
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-dev th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-dev
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-dev th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-tools
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-perf th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-perf
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-perf th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-tools
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(
-  tbody.rocm-components-system th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-system
-  td,
-#rocm-rn-components:has(
-  tbody.rocm-components-system th[rowspan]:nth-of-type(2):hover
-)
-  .rocm-components-tools
-  th:first-of-type {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-
-#rocm-rn-components:has(tbody.rocm-components-ml td:hover)
-  .rocm-components-ml
-  th,
-#rocm-rn-components:has(tbody.rocm-components-ml td:hover)
-  .rocm-components-libs
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-ml td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-communication td:hover)
-  .rocm-components-communication
-  th,
-#rocm-rn-components:has(tbody.rocm-components-communication td:hover)
-  .rocm-components-libs
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-communication td:hover)
-  tr:hover
-  > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-math td:hover)
-  .rocm-components-math
-  th,
-#rocm-rn-components:has(tbody.rocm-components-math td:hover)
-  .rocm-components-libs
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-math td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-primitives td:hover)
-  .rocm-components-primitives
-  th,
-#rocm-rn-components:has(tbody.rocm-components-primitives td:hover)
-  .rocm-components-libs
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-primitives td:hover)
-  tr:hover
-  > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-dev td:hover)
-  .rocm-components-dev
-  th,
-#rocm-rn-components:has(tbody.rocm-components-dev td:hover)
-  .rocm-components-tools
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-dev td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-perf td:hover)
-  .rocm-components-perf
-  th,
-#rocm-rn-components:has(tbody.rocm-components-perf td:hover)
-  .rocm-components-tools
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-perf td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-system td:hover)
-  .rocm-components-system
-  th,
-#rocm-rn-components:has(tbody.rocm-components-system td:hover)
-  .rocm-components-tools
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-system td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-compilers td:hover)
-  .rocm-components-compilers
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-compilers td:hover)
-  tr:hover
-  > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
-#rocm-rn-components:has(tbody.rocm-components-runtimes td:hover)
-  .rocm-components-runtimes
-  th:first-of-type,
-#rocm-rn-components:has(tbody.rocm-components-runtimes td:hover) tr:hover > td {
-  background-color: var(--pst-color-table-row-hover-bg);
-}
--- a/docs/sphinx/static/css/vllm-benchmark.css
+++ b/docs/sphinx/static/css/vllm-benchmark.css
@@ -1,74 +0,0 @@
-/* ------------------ Compatibility options grid ------------------ */
-html {
-  --compat-border-radius: 2px;
-  --compat-accent-color: var(--pst-color-primary);
-  --compat-bg-color: var(--pst-color-on-background);
-  --compat-fg-color: var(--pst-color-primary-text);
-  --compat-head-color: var(--pst-color-surface);
-  --compat-param-hover-color: var(--pst-color-link-hover);
-  --compat-param-selected-color: var(--pst-color-primary);
-  --compat-border-color: var(--pst-color-border);
-}
-
-html[data-theme="light"] {
-  --compat-param-disabled-color: var(--pst-gray-300);
-}
-
-html[data-theme="dark"] {
-  --compat-param-disabled-color: var(--pst-gray-600);
-}
-
-div#vllm-benchmark-ud-params-picker.container-fluid {
-  padding: 0 0 1rem 0;
-}
-
-div[data-param-k="model-group"],
-div[data-param-k="model"] {
-  background-color: var(--compat-bg-color);
-  padding: 2px;
-  border: solid 1px var(--compat-border-color);
-  font-weight: 500;
-  cursor: pointer;
-}
-
-div[data-param-k="model-group"][data-param-state="selected"],
-div[data-param-k="model"][data-param-state="selected"] {
-  background-color: var(--compat-param-selected-color);
-  color: var(--compat-fg-color);
-}
-
-div[data-param-k="model-group"]:hover,
-div[data-param-k="model"]:hover {
-  background-color: var(--compat-param-hover-color);
-  color: var(--compat-fg-color);
-}
-
-/*
-div[data-param-k="model-group"][data-param-state="latest-version"] {
-  background-color: var(--compat-param-selected-color);
-  color: var(--compat-fg-color);
-}
-
-div[data-param-k="model-group"][data-param-state="disabled"] {
-  background-color: var(--compat-param-disabled-color);
-  text-decoration: line-through;
-  text-decoration-color: var(--pst-color-danger);
-  cursor: auto;
-}
-*/
-
-.model-param-head {
-  background-color: var(--compat-head-color);
-  padding: 0.15rem 0.15rem 0.15rem 0.67rem;
-  border-right: solid 3px var(--compat-accent-color);
-  font-weight: 600;
-}
-
-.model-param {
-  border: solid 1px var(--compat-border-color);
-  font-weight: 500;
-}
-
-.hidden {
-  display: none !important;
-}
--- a/docs/sphinx/static/next-button-install-page.js
+++ b/docs/sphinx/static/next-button-install-page.js
@@ -0,0 +1,7 @@
+document.addEventListener("DOMContentLoaded", () => {
+  const nextLink = document.querySelector("footer.prev-next-footer a.right-next");
+  const nextTitle = nextLink.querySelector(".prev-next-title");
+  console.log(nextLink);
+  nextTitle.textContent = "Build the ROCm Core SDK from source";
+  nextLink.href = "./build-from-source.html";
+});
--- a/docs/sphinx/static/setup-toc-install-headings.js
+++ b/docs/sphinx/static/setup-toc-install-headings.js
@@ -0,0 +1,83 @@
+const TOC_QUERY = ".bd-docs-nav";
+const TOC2_QUERY = ".bd-sidebar-secondary";
+// /install/rocm.html
+const INSTALL_PAGE_DIR = "install";
+const INSTALL_PAGE_FILE = "rocm.html";
+const TOC_ENTRIES_TO_MODIFY = [
+  { tocQuery: "a[href$='redirect/_prerequisites.html']", toc2Query: "a[href='#prerequisites']" },
+  { tocQuery: "a[href$='redirect/_install.html']", toc2Query: "a[href='#installation']" },
+  { tocQuery: "a[href$='redirect/_post-install.html']", toc2Query: "a[href='#post-installation']" },
+  { tocQuery: "a[href$='redirect/_uninstall.html']", toc2Query: "a[href='#uninstalling']" },
+];
+
+function domReady(callback) {
+  if (document.readyState !== "loading") callback();
+  else document.addEventListener("DOMContentLoaded", callback, { once: true });
+}
+
+function getDocsRoot() {
+  const pathname = window.location.pathname;
+  const parts = pathname.split("/").filter(Boolean);
+
+  // If ur already inside /install/, preserve the path up to install/
+  if (pathname.includes(`/${INSTALL_PAGE_DIR}/`)) {
+    const installIdx = parts.indexOf(INSTALL_PAGE_DIR);
+    return "/" + parts.slice(0, installIdx + 1).join("/") + "/";
+  }
+
+  // HACK:
+  // Look for version pattern: at least two dots (e.g., 6.4.3, 7.10.0-preview)
+  const versionIdx = parts.findIndex(part => 
+    (part.match(/\./g) || []).length >= 2 || /^\d+$/.test(part)
+  );
+  
+  if (versionIdx !== -1) {
+    return "/" + parts.slice(0, versionIdx + 1).join("/") + `/${INSTALL_PAGE_DIR}/`;
+  }
+
+  // Fallback to root-level /install/
+  return `/${INSTALL_PAGE_DIR}/`;
+}
+
+function buildHref(docsRoot, page, hash) {
+  return `${docsRoot}${page}${hash ? "#" + hash : ""}`;
+}
+
+function watchClassChange(elem, cls, onAdd, onRemove) {
+  if (!elem) return;
+  const obs = new MutationObserver(() => {
+    elem.classList.contains(cls) ? onAdd?.() : onRemove?.();
+  });
+  obs.observe(elem, { attributes: true, attributeFilter: ["class"] });
+}
+
+domReady(() => {
+  const toc = document.querySelector(TOC_QUERY);
+  const toc2 = document.querySelector(TOC2_QUERY);
+  if (!toc) return;
+
+  const docsRoot = getDocsRoot();
+
+  TOC_ENTRIES_TO_MODIFY.forEach((item) => {
+    const tocElem = toc.querySelector(item.tocQuery);
+    if (!tocElem) {
+      console.warn(`[ROCmDocsToc]: No ${item.tocQuery} found on page`);
+      return;
+    }
+
+    const anchorId = item.toc2Query.match(/#([^'"\]]+)/)?.[1];
+    if (!anchorId) return;
+
+    tocElem.href = buildHref(docsRoot, INSTALL_PAGE_FILE, anchorId);
+
+    const toc2Elem = toc2?.querySelector(item.toc2Query);
+    if (!toc2Elem) return;
+
+    watchClassChange(
+      toc2Elem,
+      "active",
+      () => tocElem.parentElement.classList.add("current"),
+      () => tocElem.parentElement.classList.remove("current"),
+    );
+  });
+});
Author	SHA1	Message	Date
peterjunpark	ffa6360979	[docs/7.10] post-install - improve exports (#5783 )	2025-12-16 16:25:41 -05:00
peterjunpark	b22c24b949	[docs/7.10.0] Radeon cards: suggest amdgpu over RSL driver (#5770 )	2025-12-12 17:19:04 -05:00
peterjunpark	2563bd2a22	[docs/7.10.0] selector: responsive css for narrow viewports (#5769 ) Fix element overflow on narrow/mobile screens. Fix incorrect warning in matrix.py extension	2025-12-12 15:20:09 -05:00
peterjunpark	a04bb5b714	clean up ./.venv/... --> .venv/... (#5767 )	2025-12-12 00:21:09 -05:00
peterjunpark	4c1f7d402f	[docs/7.10.0] Fix typo in venv command and installation prerequisites (#5766 ) * fmt * Fix installation prerequisites and source venv typo	2025-12-12 00:06:32 -05:00
peterjunpark	e88e961519	[docs/7.10.0] selector.py: Make ids even more unique for selected content (#5765 )	2025-12-11 17:47:58 -05:00
peterjunpark	5f6018027b	fix conf.py (#5762 )	2025-12-11 17:03:50 -05:00
Peter Park	2e614775ab	Update docs for TheRock 7.10 release	2025-12-11 16:51:22 -05:00
peterjunpark	c92c9d2b57	[docs/7.9.0] Update banner msg (#5704 ) update	2025-11-26 14:36:10 -05:00
peterjunpark	1a2e4f1cc0	[docs/7.9.0] Fix rocm-cmake github link due to non-existent tag (#5684 )	2025-11-20 13:57:27 -05:00
peterjunpark	e76255db98	[docs/7.9.0] Add xDiT diffusion inference doc (#5676 )	2025-11-18 16:56:00 -05:00
Alex Xu	cdbcad6930	add preview announcement	2025-11-13 15:57:09 -05:00
Alex Xu	dc19d266b4	update rocm-docs-core to show preview banner	2025-11-12 13:53:45 -05:00
Alex Xu	8584fa3b25	update rocm-docs-core to 1.29.0 (cherry picked from commit `39de859bd1`)	2025-11-10 14:12:28 -05:00
peterjunpark	163d46ca5c	[docs/7.9.0] Fix xref in Ubuntu prerequsites and RST heading overline (#5569 )	2025-10-24 16:11:28 -04:00
peterjunpark	56f93e72de	[docs/7.9.0] Use "generic" rocm-docs-core theme (#5568 ) * use "generic" rocm-docs-core theme to tweak header * restore "nav_secondary_items"	2025-10-24 11:04:12 -04:00
peterjunpark	f004891485	[docs/7.9.0] Note rocprofiler-sdk is Instinct only. Reorg some files to match `docs/7.0.x`. (#5563 ) * move versions.md and compat-matrix to match prod; note rocprofiler-sdk is instinct only * update href in versions.md	2025-10-23 12:32:20 -04:00
peterjunpark	3c61d4fb05	[docs/7.9.0] Add build from source overview page / Point to `therocm-7.9.0` in components list (#5546 ) * Update links to components to point the `therock-7.9.0` ref * Add build from source page * lint: fix caps and update .wordlist.txt * add link to "development manuals" list * add links to TheRock's development guide and fix step 4 * wording and fmt * fix spacing * fix fmt * Fix documentation linting errors * fix spacing	2025-10-21 12:41:56 -04:00
peterjunpark	39783dcee0	[docs/7.9.0] Fix GPU marketing names in 7.9.0 release.md and compatibility matrix / Add SD3.5 ComfyUI example (#5552 ) * Add SD3.5 example to comfyui doc * Fix Ryzen AI Max (PRO) SKU names * Add names in multi line format	2025-10-21 11:02:48 -04:00
peterjunpark	c965b7e98e	Add custom version history (#5551 )	2025-10-20 18:11:38 -04:00