From f7776a159a44101c3716aea613d4a32bfea074c4 Mon Sep 17 00:00:00 2001
From: Janelle Neczypor <jneczypo@redhat.com>
Date: Thu, 20 Nov 2025 15:56:13 -0800
Subject: [PATCH] OSDOCS-16580

---
 modules/rosa-hcp-upgrade-options.adoc           |  3 +--
 .../rosa-hcp-upgrading-cli-control-plane.adoc   |  7 ++++---
 modules/rosa-hcp-upgrading-cli-machinepool.adoc | 17 +++++++++++------
 upgrading/rosa-hcp-upgrading.adoc               |  3 +++
 4 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/modules/rosa-hcp-upgrade-options.adoc b/modules/rosa-hcp-upgrade-options.adoc
index ef1aae47d4..98316b7a21 100644
--- a/modules/rosa-hcp-upgrade-options.adoc
+++ b/modules/rosa-hcp-upgrade-options.adoc
@@ -2,8 +2,7 @@
 [id="rosa-upgrade-options_{context}"]
 = Upgrade options for {product-title} clusters
 
-In OpenShift, upgrading means provisioning a new component with updated software and using it to replace an existing component that has outdated software.
-
+[role="_abstract"]
 You can control the impact of upgrades to your workload by controlling which parts of the cluster are upgraded, for example:
 
 Upgrade only the hosted control plane:: This initiates upgrade of the hosted control plane. It does not impact your worker nodes.
diff --git a/modules/rosa-hcp-upgrading-cli-control-plane.adoc b/modules/rosa-hcp-upgrading-cli-control-plane.adoc
index 65541b1fe2..4f741d8c23 100644
--- a/modules/rosa-hcp-upgrading-cli-control-plane.adoc
+++ b/modules/rosa-hcp-upgrading-cli-control-plane.adoc
@@ -10,6 +10,7 @@
 ifeval::["{context}" != "rosa-hcp-upgrading-whole-cluster"]
 = Upgrading the hosted control plane with the ROSA CLI
 
+[role="_abstract"]
 You can manually upgrade the hosted control plane of a {product-title} cluster by using the ROSA CLI. This method schedules the control plane for an upgrade if a more recent version is available, either immediately, or at a specified future time.
 
 [NOTE]
@@ -40,9 +41,9 @@ endif::[]
 +
 [source,terminal]
 ----
-$ rosa describe cluster --cluster=<cluster_name_or_id> <1>
+$ rosa describe cluster --cluster=<cluster_name_or_id>
 ----
-<1> Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.
+Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.
 
 . List the versions that you can upgrade your control plane to by running the following command:
 +
@@ -53,7 +54,7 @@ $ rosa list upgrade --cluster=<cluster_name_or_id>
 +
 The command returns a list of available updates, including the recommended version.
 +
-.Example output
+*Example output*
 +
 [source,terminal]
 ----
diff --git a/modules/rosa-hcp-upgrading-cli-machinepool.adoc b/modules/rosa-hcp-upgrading-cli-machinepool.adoc
index d74a498642..a3b9f27146 100644
--- a/modules/rosa-hcp-upgrading-cli-machinepool.adoc
+++ b/modules/rosa-hcp-upgrading-cli-machinepool.adoc
@@ -10,6 +10,7 @@
 ifeval::["{context}" != "rosa-hcp-upgrading-whole-cluster"]
 = Upgrading machine pools with the ROSA CLI
 
+[role="_abstract"]
 You can manually upgrade one or more machine pools in a {hcp-title} cluster by using the ROSA CLI. This method schedules the specified machine pool for an upgrade if a more recent version is available, either immediately, or at a specified future time.
 
 [NOTE]
@@ -41,19 +42,22 @@ Machine pool configurations such as node drain timeout, max-unavailable, and max
 +
 [source,terminal]
 ----
-$ rosa describe cluster --cluster=<cluster_name_or_id> <1>
+$ rosa describe cluster --cluster=<cluster_name_or_id>
 ----
-<1> Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.
+Replace `<cluster_name_or_id>` with the cluster name or the cluster ID.
 +
 ifeval::["{context}" != "rosa-hcp-upgrading-whole-cluster"]
-.Example output
+
+*Example output*
++
 [source,terminal]
 ----
 OpenShift Version:     4.14.0
 ----
 endif::[]
 ifeval::["{context}" == "rosa-hcp-upgrading-whole-cluster"]
-.Example output
+*Example output*
++
 [source,terminal]
 ----
 OpenShift Version:     4.14.8
@@ -70,7 +74,7 @@ $ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>
 +
 The command returns a list of available updates, including the recommended version.
 +
-.Example output
+*Example output*
 +
 [source,terminal]
 ----
@@ -93,7 +97,8 @@ Do not upgrade your machine pool to a version higher than your control plane. If
 $ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>
 ----
 +
-.Example output
+*Example output*
++
 [source,terminal]
 ----
 Replicas: 5
diff --git a/upgrading/rosa-hcp-upgrading.adoc b/upgrading/rosa-hcp-upgrading.adoc
index 91fb00f222..fb6cce968f 100644
--- a/upgrading/rosa-hcp-upgrading.adoc
+++ b/upgrading/rosa-hcp-upgrading.adoc
@@ -6,6 +6,9 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 
 toc::[]
 
+[role="_abstract"]
+In {product-title}, upgrading provisions a new component with updated software and uses it to replace an existing component that has outdated software.
+
 include::modules/rosa-hcp-upgrade-options.adoc[leveloffset=+1]
 
 .Additional resources