[rhacs-docs-4.11] [RHACS] [Docs] ROX-33164: Fixing DITA errors in cloud_service/upgrading-cloud/upgrade-cloudsvc-operator.adoc

cloud_service/upgrading-cloud/upgrade-cloudsvc-operator.adoc

@@ -12,35 +12,28 @@ Red{nbsp}Hat provides regular service updates for the components that it manages
 
 You must regularly upgrade the version of {product-title-short} on your secured clusters to ensure compatibility with {product-title-managed-short}.
 
+//Preparing to upgrade
 include::modules/prepare-operator-upgrades.adoc[leveloffset=+1]
+
 include::modules/change-collection-method.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
 .Additional resources
 * link:https://docs.openshift.com/container-platform/latest/operators/admin/olm-upgrading-operators.html[Updating installed Operators]
 
-[id="rollback-operator-upgrade-cloud"]
-== Rolling back an Operator upgrade for secured clusters
-
-To roll back an Operator upgrade, you can use either the CLI or the {ocp} web console.
-
-[NOTE]
-====
-On secured clusters, rolling back Operator upgrades is needed only in rare cases, for example, if an issue exists with the secured cluster.
-====
+//Rolling back an Operator upgrade for secured clusters
+include::modules/rollback-operator-upgrade-cloud.adoc[leveloffset=+1]
 
 include::modules/rollback-operator-upgrades-cli.adoc[leveloffset=+2]
+
 include::modules/rollback-operator-upgrades-console.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
 .Additional resources
 * link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.16/html/operators/understanding-operators#olm-workflow[Operator Lifecycle Manager workflow]
 * link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.16/html/operators/administrator-tasks#olm-approving-pending-upgrade_olm-upgrading-operators[Manually approving a pending Operator update]
 
-[id="operator-upgrade-troubleshooting_{context}"]
-== Troubleshooting Operator upgrade issues
-
-[role="_abstract"]
-Follow these instructions to investigate and resolve upgrade-related issues for the {product-title-short} Operator.
+//Troubleshooting Operator upgrade issues
+include::modules/operator-upgrade-troubleshooting.adoc[leveloffset=+1]
 
 include::modules/operator-upgrade-fail-to-deploy.adoc[leveloffset=+2]

modules/operator-upgrade-troubleshooting.adoc

@@ -1,6 +1,7 @@
 // Module included in the following assemblies:
 //
 // * upgrading/upgrade-operator.adoc
+// * cloud_service/upgrading-cloud/upgrade-cloudsvc-operator.adoc
 
 :_mod-docs-content-type: CONCEPT
 [id="operator-upgrade-troubleshooting_{context}"]

modules/rollback-operator-upgrade-cloud.adoc

@@ -0,0 +1,15 @@
+// Module included in the following assemblies:
+//
+// * cloud_service/upgrading-cloud/upgrade-cloudsvc-operator.adoc
+
+:_mod-docs-content-type: CONCEPT
+[id="rollback-operator-upgrade-cloud_{context}"]
+= Rolling back an Operator upgrade for secured clusters
+
+[role="_abstract"]
+To roll back an Operator upgrade, you can use either the CLI or the {ocp} web console.
+
+[NOTE]
+====
+On secured clusters, you only need to roll back Operator upgrades in rare cases, for example, if an issue exists with the secured cluster.
+====