From c56b00aad5f92c4bc540a4ab01dd4eef50a08a69 Mon Sep 17 00:00:00 2001
From: Juanita Balaraj <juanita.balaraj@windriver.com>
Date: Wed, 31 Jul 2024 22:12:29 +0000
Subject: [PATCH] Updated Steps for
 https://review.opendev.org/c/starlingx/docs/+/924366

Comments addressed in https://review.opendev.org/c/starlingx/docs/+/924520

Change-Id: I6fd574d95edef5010a80145bedcbe91018d8860c
Signed-off-by: Juanita Balaraj <juanita.balaraj@windriver.com>
---
 ...lti-version-upgrade-in-aio-sx-13e05ba19840.rst | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/doc/source/updates/kubernetes/manual-kubernetes-multi-version-upgrade-in-aio-sx-13e05ba19840.rst b/doc/source/updates/kubernetes/manual-kubernetes-multi-version-upgrade-in-aio-sx-13e05ba19840.rst
index b723d7eb8..7592d23c9 100644
--- a/doc/source/updates/kubernetes/manual-kubernetes-multi-version-upgrade-in-aio-sx-13e05ba19840.rst
+++ b/doc/source/updates/kubernetes/manual-kubernetes-multi-version-upgrade-in-aio-sx-13e05ba19840.rst
@@ -185,6 +185,8 @@ system. This feature is not supported in the system which is not |AIO-SX|.
 
 #.  Upgrade Kubernetes networking.
 
+    .. _upgrade_kubernetes_networking:
+
     .. code-block:: none
 
         ~(keystone_admin)]$ system kube-upgrade-networking
@@ -218,6 +220,8 @@ system. This feature is not supported in the system which is not |AIO-SX|.
 
 #.  |optional| Cordon
 
+    .. _cordon:
+
     The :command:`kube-host-cordon` command will evict the regular pods from
     the host. This command will prevent the application from running on
     intermediate versions.
@@ -259,6 +263,8 @@ system. This feature is not supported in the system which is not |AIO-SX|.
 
 #.  Upgrade the control plane on controller-0.
 
+    .. _upgrade_control_plane:
+
     .. code-block:: none
 
         ~(keystone_admin)]$ system kube-host-upgrade controller-0 control-plane
@@ -318,13 +324,14 @@ system. This feature is not supported in the system which is not |AIO-SX|.
     The status **upgraded-kubelet** will be entered when the kubelet upgrade
     has completed.
 
-    Repeat steps 8 and 9 to reach the target Kubernetes version. For example, in
-    this case, we need to repeat steps 8 and 9 twice for the remaining
-    versions v1.23.1 and v1.24.4.
+    Repeat steps :ref:`Cordon <cordon>` and :ref:`Upgrade the control plane <upgrade_control_plane>`
+    to reach the target Kubernetes version. For example, in this case, repeat
+    steps :ref:`Cordon <cordon>` and :ref:`Upgrade the control plane <upgrade_control_plane>`
+    twice for the remaining versions v1.23.1 and v1.24.4.
 
 #. |optional| Run the ``uncordon`` subcommand.
 
-   Skip this step if you did not perform step 7.
+   Skip this step if you did not perform step :ref:`Upgrade Kubernetes Networking <upgrade_kubernetes_networking>`.
 
    The :command:`kube-host-uncordon` command will allow the regular pods on the
    host again.