(DOCSP-7492): Tweaking presentation of upgrade procs

Author: jeff-allen-mongo

source/includes/toc-upgrade.yaml

@@ -1,7 +1,3 @@
-file: /tutorial/migrate-to-single-resource
-description: |
-  .. include:: /includes/fact-migrate-to-single-resource.rst
----
 file: /tutorial/upgrade-k8s-operator
 description: |
   Follow this upgrade procedure if you are running version 0.10 or
@@ -11,4 +7,8 @@ file: /tutorial/upgrade-k8s-operator-v9-and-earlier
 description:
   Follow this upgrade procedure if you are running version 0.9 or
   earlier.
+---
+file: /tutorial/migrate-to-single-resource
+description: |
+  .. include:: /includes/fact-migrate-to-single-resource.rst
 ...

source/tutorial/migrate-to-single-resource.txt

@@ -2,9 +2,9 @@
 
 .. _migrate-single-cluster:
 
-============================================================
-Upgrade to Operator Version 1.3.0 (One Resource per Project)
-============================================================
+================================================================
+Migrate to One Resource per Project (Required for Version 1.3.0)
+================================================================
 
 .. default-domain:: mongodb
 
@@ -18,6 +18,13 @@ Upgrade to Operator Version 1.3.0 (One Resource per Project)
 
 .. include:: /includes/fact-migrate-to-single-resource.rst
 
+Prerequisites
+-------------
+
+Before completing this procedure, ensure that you have upgraded your
+|k8s-op| to version 1.3.0. For upgrade instructions, see
+:ref:`upgrade-k8s-operator`.
+
 Procedure
 ---------
 

source/tutorial/upgrade-k8s-operator.txt

@@ -2,9 +2,9 @@
 
 .. _upgrade-k8s-operator:
 
-============================================
-Upgrade from Operator Version 0.10 and Later
-============================================
+====================
+Upgrade the Operator
+====================
 
 .. default-domain:: mongodb
 
@@ -16,12 +16,12 @@ Upgrade from Operator Version 0.10 and Later
 
 .. include:: /includes/styles/corrections.rst
 
-.. warning::
+Procedure
+---------
 
-   Version 0.10 of the |k8s-op-full| included breaking changes and
-   requires some additional preparation before upgrading. If you are
-   using version 0.9 or earlier, see :ref:`upgrade-k8s-operator-v10`.
+.. include:: /includes/upgrade-k8s-operator.rst
 
-The following procedure walks you through upgrading the |k8s-op-short|:
+Additional Considerations for Version 1.3.0
+-------------------------------------------
 
-.. include:: /includes/upgrade-k8s-operator.rst
+.. include:: /includes/fact-one-cluster-per-proj.rst