Docs: resolve warnings from sphinx build output

2026-01-09 14:48:06 -05:00 · 2025-01-14 13:58:55 +01:00
parent 82d7903e41
commit 7754fc4b9d
12 changed files with 112 additions and 103 deletions
--- a/docs/compatibility/compatibility-matrix.rst
+++ b/docs/compatibility/compatibility-matrix.rst
@@ -169,11 +169,11 @@ Use this lookup table to confirm which operating system and kernel versions are
   `Ubuntu <https://ubuntu.com/about/release-cycle#ubuntu-kernel-release-cycle>`_, 22.04.5, "5.15 GA, 6.8 HWE"
   , 22.04.4, "5.15 GA, 6.5 HWE"
   ,,
-   `Red Hat Enterprise Linux (RHEL) <https://access.redhat.com/articles/3078#RHEL9>`_, 9.5, 5.14.0
+   `Red Hat Enterprise Linux (RHEL 9) <https://access.redhat.com/articles/3078#RHEL9>`_, 9.5, 5.14.0
   ,9.4, 5.14.0
   ,9.3, 5.14.0
   ,,
-   `Red Hat Enterprise Linux (RHEL) <https://access.redhat.com/articles/3078#RHEL8>`_, 8.10, 4.18.0
+   `Red Hat Enterprise Linux (RHEL 8) <https://access.redhat.com/articles/3078#RHEL8>`_, 8.10, 4.18.0
   ,8.9, 4.18.0
   ,,
   `SUSE Linux Enterprise Server (SLES) <https://www.suse.com/support/kb/doc/?id=000019587#SLE15SP4>`_, 15 SP6, 6.4.0
--- a/docs/compatibility/ml-compatibility/jax-compatibility.rst
+++ b/docs/compatibility/ml-compatibility/jax-compatibility.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 .. meta::
   :description: JAX compatibility
   :keywords: GPU, JAX compatibility
@@ -22,14 +24,14 @@ support:

  - Offers AMD-validated and community :ref:`Docker images <jax-docker-compat>` with ROCm and JAX pre-installed.

-  - ROCm JAX repository: `<https://github.com/ROCm/jax>`__
+  - ROCm JAX repository: `ROCm/jax <https://github.com/ROCm/jax>`_

  - See the :doc:`ROCm JAX installation guide <rocm-install-on-linux:install/3rd-party/jax-install>`
    to get started.

 - Official JAX release:

-  - Official JAX repository: `<https://github.com/jax-ml/jax>`__
+  - Official JAX repository: `jax-ml/jax <https://github.com/jax-ml/jax>`_

  - See the `AMD GPU (Linux) installation section
    <https://jax.readthedocs.io/en/latest/installation.html#amd-gpu-linux>`_ in the JAX
@@ -51,8 +53,8 @@ Docker image compatibility

   <i class="fab fa-docker"></i>

-AMD validates and publishes ready-made `JAX <https://hub.docker.com/r/rocm/jax/>`_
-images with ROCm backends on Docker Hub. The following Docker image tags and
+AMD validates and publishes ready-made `ROCm JAX Docker images <https://hub.docker.com/r/rocm/jax>`_
+with ROCm backends on Docker Hub. The following Docker image tags and
 associated inventories are validated for
 `ROCm 6.3.1 <https://repo.radeon.com/rocm/apt/6.3.1/>`_. Click the |docker-icon|
 icon to view the image on Docker Hub.
@@ -79,8 +81,8 @@ icon to view the image on Docker Hub.
      - Ubuntu 22.04
      - `3.10.14 <https://www.python.org/downloads/release/python-31014/>`_

-AMD publishes community `JAX <https://hub.docker.com/r/rocm/jax-community>`_
-images with ROCm backends on Docker Hub. The following Docker image tags and
+AMD publishes `Community ROCm JAX Docker images <https://hub.docker.com/r/rocm/jax-community>`_
+with ROCm backends on Docker Hub. The following Docker image tags and
 associated inventories are tested for `ROCm 6.2.4 <https://repo.radeon.com/rocm/apt/6.2.4/>`_.

 .. list-table:: JAX community Docker image components
--- a/docs/compatibility/ml-compatibility/pytorch-compatibility.rst
+++ b/docs/compatibility/ml-compatibility/pytorch-compatibility.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 .. meta::
    :description: PyTorch compatibility
    :keywords: GPU, PyTorch compatibility
@@ -23,7 +25,7 @@ release cycles for PyTorch on ROCm:
  - Offers :ref:`Docker images <pytorch-docker-compat>` with ROCm and PyTorch
    pre-installed.

-  - ROCm PyTorch repository: `<https://github.com/ROCm/pytorch>`__
+  - ROCm PyTorch repository: `<https://github.com/ROCm/pytorch>`_

  - See the :doc:`ROCm PyTorch installation guide <rocm-install-on-linux:install/3rd-party/pytorch-install>` to get started.

@@ -31,7 +33,7 @@ release cycles for PyTorch on ROCm:

  - Provides the latest stable version of PyTorch but doesn't immediately support the latest ROCm version.

-  - Official PyTorch repository: `<https://github.com/pytorch/pytorch>`__
+  - Official PyTorch repository: `<https://github.com/pytorch/pytorch>`_

  - See the `Nightly and latest stable version installation guide <https://pytorch.org/get-started/locally/>`_
    or `Previous versions <https://pytorch.org/get-started/previous-versions/>`_ to get started.
@@ -52,8 +54,8 @@ Docker image compatibility

   <i class="fab fa-docker"></i>

-AMD validates and publishes ready-made `PyTorch <https://hub.docker.com/r/rocm/pytorch>`_
-images with ROCm backends on Docker Hub. The following Docker image tags and
+AMD validates and publishes ready-made `PyTorch images <https://hub.docker.com/r/rocm/pytorch>`_
+with ROCm backends on Docker Hub. The following Docker image tags and
 associated inventories are validated for `ROCm 6.3.0 <https://repo.radeon.com/rocm/apt/6.3/>`_.
 Click the |docker-icon| icon to view the image on Docker Hub.

@@ -82,7 +84,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.
      - `3.12 <https://www.python.org/downloads/release/python-3128/>`_
      - `1.4.0 <https://github.com/ROCm/apex/tree/release/1.4.0>`_
      - `0.19.0 <https://github.com/pytorch/vision/tree/v0.19.0>`_
-      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13>`_
+      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
      - `master <https://bitbucket.org/icl/magma/src/master/>`_
      - `1.10.0 <https://github.com/openucx/ucx/tree/v1.10.0>`_
      - `4.0.7 <https://github.com/open-mpi/ompi/tree/v4.0.7>`_
@@ -97,7 +99,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.
      - `3.10 <https://www.python.org/downloads/release/python-31016/>`_
      - `1.4.0 <https://github.com/ROCm/apex/tree/release/1.4.0>`_
      - `0.19.0 <https://github.com/pytorch/vision/tree/v0.19.0>`_
-      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13>`_
+      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
      - `master <https://bitbucket.org/icl/magma/src/master/>`_
      - `1.10.0 <https://github.com/openucx/ucx/tree/v1.10.0>`_
      - `4.0.7 <https://github.com/open-mpi/ompi/tree/v4.0.7>`_
@@ -109,10 +111,10 @@ Click the |docker-icon| icon to view the image on Docker Hub.

      - `2.4.0 <https://github.com/ROCm/pytorch/tree/release/2.4>`_
      - 22.04
-      - `3.9 <https://www.python.org/downloads/release/python-3918/>`_
+      - `3.9.18 <https://www.python.org/downloads/release/python-3918/>`_
      - `1.4.0 <https://github.com/ROCm/apex/tree/release/1.4.0>`_
      - `0.19.0 <https://github.com/pytorch/vision/tree/v0.19.0>`_
-      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13>`_
+      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
      - `master <https://bitbucket.org/icl/magma/src/master/>`_
      - `1.10.0 <https://github.com/openucx/ucx/tree/v1.10.0>`_
      - `4.0.7 <https://github.com/open-mpi/ompi/tree/v4.0.7>`_
@@ -127,7 +129,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.
      - `3.10 <https://www.python.org/downloads/release/python-31016/>`_
      - `1.3.0 <https://github.com/ROCm/apex/tree/release/1.3.0>`_
      - `0.18.0 <https://github.com/pytorch/vision/tree/v0.18.0>`_
-      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13>`_
+      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
      - `master <https://bitbucket.org/icl/magma/src/master/>`_
      - `1.14.1 <https://github.com/openucx/ucx/tree/v1.14.1>`_
      - `4.1.5 <https://github.com/open-mpi/ompi/tree/v4.1.5>`_
@@ -142,7 +144,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.
      - `3.10 <https://www.python.org/downloads/release/python-31016/>`_
      - `1.2.0 <https://github.com/ROCm/apex/tree/release/1.2.0>`_
      - `0.17.1 <https://github.com/pytorch/vision/tree/v0.17.1>`_
-      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13>`_
+      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
      - `master <https://bitbucket.org/icl/magma/src/master/>`_
      - `1.14.1 <https://github.com/openucx/ucx/tree/v1.14.1>`_
      - `4.1.5 <https://github.com/open-mpi/ompi/tree/v4.1.5>`_
@@ -154,7 +156,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.

      - `2.2.1 <https://github.com/ROCm/pytorch/tree/release/2.2>`_
      - 20.04
-      - `3.9 <https://www.python.org/downloads/release/python-3921/>`_
+      - `3.9.21 <https://www.python.org/downloads/release/python-3921/>`_
      - `1.2.0 <https://github.com/ROCm/apex/tree/release/1.2.0>`_
      - `0.17.1 <https://github.com/pytorch/vision/tree/v0.17.1>`_
      - `2.13.0 <https://github.com/tensorflow/tensorboard/tree/2.13.0>`_
@@ -169,7 +171,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.

      - `1.13.1 <https://github.com/ROCm/pytorch/tree/release/1.13>`_
      - 22.04
-      - `3.9 <https://www.python.org/downloads/release/python-3921/>`_
+      - `3.9.21 <https://www.python.org/downloads/release/python-3921/>`_
      - `1.0.0 <https://github.com/ROCm/apex/tree/release/1.0.0>`_
      - `0.14.0 <https://github.com/pytorch/vision/tree/v0.14.0>`_
      - `2.18.0 <https://github.com/tensorflow/tensorboard/tree/2.18>`_
@@ -184,7 +186,7 @@ Click the |docker-icon| icon to view the image on Docker Hub.

      - `1.13.1 <https://github.com/ROCm/pytorch/tree/release/1.13>`_
      - 20.04
-      - `3.9 <https://www.python.org/downloads/release/python-3921/>`_
+      - `3.9.21 <https://www.python.org/downloads/release/python-3921/>`_
      - `1.0.0 <https://github.com/ROCm/apex/tree/release/1.0.0>`_
      - `0.14.0 <https://github.com/pytorch/vision/tree/v0.14.0>`_
      - `2.18.0 <https://github.com/tensorflow/tensorboard/tree/2.18>`_
--- a/docs/compatibility/ml-compatibility/tensorflow-compatibility.rst
+++ b/docs/compatibility/ml-compatibility/tensorflow-compatibility.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 .. meta::
    :description: TensorFlow compatibility
    :keywords: GPU, TensorFlow compatibility
@@ -49,8 +51,8 @@ Docker image compatibility

   <i class="fab fa-docker"></i>

-AMD validates and publishes ready-made `TensorFlow
-<https://hub.docker.com/r/rocm/tensorflow>`_ images with ROCm backends on
+AMD validates and publishes ready-made `TensorFlow images
+<https://hub.docker.com/r/rocm/tensorflow>`_ with ROCm backends on
 Docker Hub. The following Docker image tags and associated inventories are
 validated for `ROCm 6.3.1 <https://repo.radeon.com/rocm/apt/6.3.1/>`_. Click
 the |docker-icon| icon to view the image on Docker Hub.
@@ -68,7 +70,7 @@ the |docker-icon| icon to view the image on Docker Hub.

           <a href="https://hub.docker.com/layers/rocm/tensorflow/rocm6.3.1-py3.12-tf2.17.0-dev/images/sha256-804121ee4985718277ba7dcec53c57bdade130a1ef42f544b6c48090ad379c17"><i class="fab fa-docker fa-lg"></i> rocm/tensorflow</a>

-      - `tensorflow-rocm 2.17.0 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.17.0-cp312-cp312-manylinux_2_28_x86_64.whl>`_
+      - `tensorflow-rocm 2.17.0 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.17.0-cp312-cp312-manylinux_2_28_x86_64.whl>`__
      - dev
      - `Python 3.12 <https://www.python.org/downloads/release/python-3124/>`_
      - `TensorBoard 2.17.1 <https://github.com/tensorflow/tensorboard/tree/2.17.1>`_
@@ -77,7 +79,7 @@ the |docker-icon| icon to view the image on Docker Hub.

           <a href="https://hub.docker.com/layers/rocm/tensorflow/rocm6.3.1-py3.10-tf2.17.0-dev/images/sha256-776837ffa945913f6c466bfe477810a11453d21d5b6afb200be1c36e48fbc08e"><i class="fab fa-docker fa-lg"></i> rocm/tensorflow</a>

-      - `tensorflow-rocm 2.17.0 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.17.0-cp310-cp310-manylinux_2_28_x86_64.whl>`_
+      - `tensorflow-rocm 2.17.0 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.17.0-cp310-cp310-manylinux_2_28_x86_64.whl>`__
      - dev
      - `Python 3.10 <https://www.python.org/downloads/release/python-31012/>`_
      - `TensorBoard 2.17.0 <https://github.com/tensorflow/tensorboard/tree/2.17.0>`_
@@ -86,7 +88,7 @@ the |docker-icon| icon to view the image on Docker Hub.

           <a href="https://hub.docker.com/layers/rocm/tensorflow/rocm6.3.1-py3.12-tf2.16.2-dev/images/sha256-c793e1483e30809c3c28fc5d7805bedc033c73da224f839fff370717cb100944"><i class="fab fa-docker fa-lg"></i> rocm/tensorflow</a>

-      - `tensorflow-rocm 2.16.2 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.16.2-cp312-cp312-manylinux_2_28_x86_64.whl>`_
+      - `tensorflow-rocm 2.16.2 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.16.2-cp312-cp312-manylinux_2_28_x86_64.whl>`__
      - dev
      - `Python 3.12 <https://www.python.org/downloads/release/python-3124/>`_
      - `TensorBoard 2.16.2 <https://github.com/tensorflow/tensorboard/tree/2.16.2>`_
@@ -95,7 +97,7 @@ the |docker-icon| icon to view the image on Docker Hub.

           <a href="https://hub.docker.com/layers/rocm/tensorflow/rocm6.3.1-py3.10-tf2.16.0-dev/images/sha256-263e78414ae85d7bcd52a025a94131d0a279872a45ed632b9165336dfdcd4443"><i class="fab fa-docker fa-lg"></i> rocm/tensorflow</a>

-      - `tensorflow-rocm 2.16.2 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.16.2-cp310-cp310-manylinux_2_28_x86_64.whl>`_
+      - `tensorflow-rocm 2.16.2 <https://repo.radeon.com/rocm/manylinux/rocm-rel-6.3/tensorflow_rocm-2.16.2-cp310-cp310-manylinux_2_28_x86_64.whl>`__
      - dev
      - `Python 3.10 <https://www.python.org/downloads/release/python-31012/>`_
      - `TensorBoard 2.16.2 <https://github.com/tensorflow/tensorboard/tree/2.16.2>`_
--- a/docs/conceptual/ai-pytorch-inception.md
+++ b/docs/conceptual/ai-pytorch-inception.md
@@ -53,7 +53,7 @@ The following sections contain case studies for the Inception V3 model.

 ### Inception V3 with PyTorch

-Convolution Neural Networks are forms of artificial neural networks commonly used for image processing. One of the core layers of such a network is the convolutional layer, which convolves the input with a weight tensor and passes the result to the next layer. Inception V3[^inception_arch] is an architectural development over the ImageNet competition-winning entry, AlexNet, using more profound and broader networks while attempting to meet computational and memory budgets.
+Convolution Neural Networks are forms of artificial neural networks commonly used for image processing. One of the core layers of such a network is the convolutional layer, which convolves the input with a weight tensor and passes the result to the next layer. Inception V3 is an architectural development over the ImageNet competition-winning entry, AlexNet, using more profound and broader networks while attempting to meet computational and memory budgets.

 The implementation uses PyTorch as a framework. This case study utilizes [TorchVision](https://pytorch.org/vision/stable/index.html), a repository of popular datasets and model architectures, for obtaining the model. TorchVision also provides pre-trained weights as a starting point to develop new models or fine-tune the model for a new task.

@@ -162,7 +162,7 @@ Follow these steps:
    docker run -it --cap-add=SYS_PTRACE --security-opt seccomp=unconfined --device=/dev/kfd --device=/dev/dri --group-add video --ipc=host --shm-size 8G rocm/pytorch:latest
    ```

-2. Download an ImageNet database. For this example, the `tiny-imagenet-200`[^Stanford_deep_learning], a smaller ImageNet variant with 200 image classes and a training dataset with 100,000 images, was downsized to 64x64 color images.
+2. Download an ImageNet database. For this example, the `tiny-imagenet-200`, a smaller ImageNet variant with 200 image classes and a training dataset with 100,000 images, was downsized to 64x64 color images.

    ```bash
    wget http://cs231n.stanford.edu/tiny-imagenet-200.zip
@@ -366,7 +366,7 @@ Follow these steps:
    model.to(device)
    ```

-13. Set the loss criteria. For this example, Cross Entropy Loss[^cross_entropy] is used.
+13. Set the loss criteria. For this example, Cross Entropy Loss is used.

    ```py
    criterion = torch.nn.CrossEntropyLoss()
@@ -586,7 +586,7 @@ Follow these steps:
    import torch.optim as optim
    ```

-10. Set the loss criteria. For this example, Cross Entropy Loss[^cross_entropy] is used.
+10. Set the loss criteria. For this example, Cross Entropy Loss is used.

    ```py
    criterion = nn.CrossEntropyLoss()
--- a/docs/how-to/programming_guide.rst
+++ b/docs/how-to/programming_guide.rst
@@ -1,3 +1,5 @@
+:orphan:
+
 .. meta::
    :description: Programming guide
    :keywords: HIP, programming guide, heterogeneous programming, AMD GPU programming
--- a/docs/how-to/rocm-for-hpc/index.rst
+++ b/docs/how-to/rocm-for-hpc/index.rst
@@ -20,7 +20,7 @@ applications.
 * For more information, see :doc:`What is ROCm? <../../what-is-rocm>`.

 * For guidance on installing ROCm, see :doc:`rocm-install-on-linux:index`. See
-  the :doc:`../../compatibility/compatibility-matrix` for details on hardware
+  the :doc:`Compatibility matrix <../../compatibility/compatibility-matrix>` for details on hardware
  and operating system support.

 Some of the most popular HPC frameworks are part of the ROCm platform, including
--- a/docs/index.md
+++ b/docs/index.md
@@ -62,16 +62,15 @@ ROCm documentation is organized into the following categories:
 * [Oversubscription of hardware resources](./conceptual/oversubscription.rst)
 :::

-<!-- markdownlint-disable MD051 -->
 :::{grid-item-card} Reference
 :class-body: rocm-card-banner rocm-hue-6
-
+<!-- markdownlint-disable MD051 -->
 * [ROCm libraries](./reference/api-libraries.md)
 * [ROCm tools, compilers, and runtimes](./reference/rocm-tools.md)
 * [Accelerator and  GPU hardware specifications](./reference/gpu-arch-specs.rst)
 * [Precision support](./reference/precision-support.rst)
 * [Graph safe support](./reference/graph-safe-support.rst)
-:::
 <!-- markdownlint-enable MD051 -->
+:::

 ::::
--- a/docs/reference/api-libraries.md
+++ b/docs/reference/api-libraries.md
@@ -12,11 +12,11 @@
 :gutter: 3
 :class-container: rocm-doc-grid

-(artificial-intelligence-apis)=
-
 :::{grid-item-card} Machine Learning and Computer Vision
 :class-body: rocm-card-banner rocm-hue-3

+(artificial-intelligence-apis)=
+
 * {doc}`Composable Kernel <composable_kernel:index>`
 * {doc}`MIGraphX <amdmigraphx:index>`
 * {doc}`MIOpen <miopen:index>`
@@ -28,30 +28,30 @@
 * {doc}`ROCm Performance Primitives (RPP) <rpp:index>`
 :::

-(cpp-primitives)=
-
 :::{grid-item-card} Primitives
 :class-body: rocm-card-banner rocm-hue-12

+(cpp-primitives)=
+
 * {doc}`hipCUB <hipcub:index>`
 * {doc}`hipTensor <hiptensor:index>`
 * {doc}`rocPRIM <rocprim:index>`
 * {doc}`rocThrust <rocthrust:index>`
 :::

-(communication-libraries)=
-
 :::{grid-item-card} Communication
 :class-body: rocm-card-banner rocm-hue-7

+(communication-libraries)=
+
 * {doc}`RCCL <rccl:index>`
 :::

-(math-apis)=
-
 :::{grid-item-card} Math
 :class-body: rocm-card-banner rocm-hue-6

+(math-apis)=
+
 * [half](https://github.com/ROCm/half)
 * {doc}`hipBLAS <hipblas:index>` / {doc}`rocBLAS <rocblas:index>`
 * {doc}`hipBLASLt <hipblaslt:index>`
--- a/docs/reference/precision-support.rst
+++ b/docs/reference/precision-support.rst
@@ -467,7 +467,7 @@ description, refer to the corresponding library data type support page.
        - ❌/❌
        - ❌/❌
      *
-        - rocRAND (:doc:`details <rocrand:data-type-support>`)
+        - rocRAND (:doc:`details <rocrand:api-reference/data-type-support>`)
        - -/❌
        - -/❌
        - -/✅
--- a/docs/reference/rocm-tools.md
+++ b/docs/reference/rocm-tools.md
@@ -12,11 +12,11 @@
 :gutter: 3
 :class-container: rocm-doc-grid

-(system-tools)=
-
 :::{grid-item-card} System Management
 :class-body: rocm-card-banner rocm-hue-1

+(system-tools)=
+
 * {doc}`AMD SMI <amdsmi:index>`
 * {doc}`ROCm Data Center Tool <rdc:index>`
 * {doc}`rocminfo <rocminfo:index>`
@@ -24,11 +24,11 @@
 * {doc}`ROCm Validation Suite <rocmvalidationsuite:index>`
 :::

-(performance-tools)=
-
 :::{grid-item-card} Performance
 :class-body: rocm-card-banner rocm-hue-6

+(performance-tools)=
+
 * {doc}`ROCm Bandwidth Test <rocm_bandwidth_test:index>`
 * {doc}`ROCm Compute Profiler <rocprofiler-compute:index>`
 * {doc}`ROCm Systems Profiler <rocprofiler-systems:index>`
@@ -37,11 +37,11 @@
 * {doc}`ROCTracer <roctracer:index>`
 :::

-(development-tools)=
-
 :::{grid-item-card} Development
 :class-body: rocm-card-banner rocm-hue-1

+(development-tools)=
+
 * {doc}`ROCm CMake <rocmcmakebuildtools:index>`
 * {doc}`HIPIFY <hipify:index>`
 * {doc}`ROCdbgapi <rocdbgapi:index>`
@@ -49,21 +49,21 @@
 * {doc}`ROCr Debug Agent <rocr_debug_agent:index>`
 :::

-(compilers)=
-
 :::{grid-item-card} Compilers
 :class-body: rocm-card-banner rocm-hue-8

+(compilers)=
+
 * {doc}`ROCm Compilers <llvm-project:index>`
 * {doc}`HIPCC <hipcc:index>`
 * [FLANG](https://github.com/ROCm/flang/)
 :::

-(runtimes)=
-
 :::{grid-item-card} Runtimes
 :class-body: rocm-card-banner rocm-hue-12

+(runtimes)=
+
 * {doc}`AMD Compute Language Runtime (CLR) <hip:understand/amd_clr>`
 * {doc}`HIP <hip:index>`
 * {doc}`ROCR-Runtime <rocr-runtime:index>`
--- a/docs/release/versions.md
+++ b/docs/release/versions.md
@@ -1,3 +1,5 @@
+:orphan:
+
 <head>
  <meta charset="UTF-8">
  <meta name="description" content="ROCm release history">