JM edits

Author: ajhuh-mdb

source/includes/steps-upgrade-master.yaml

@@ -39,6 +39,8 @@ replacement:
         persistent: false
        ...
 
+    The following example shows the result of this change:
+    
     .. code-block:: yaml
 
       spec:

source/includes/steps-upgrade-mdb.yaml

@@ -5,7 +5,7 @@ inherit:
   file: steps-upgrade-master.yaml
   ref: upgrade-master-version
 replacement:
-  method: "Perform the following modifications to the resource's ConfigMap:"
+  method: "Change the resource's ConfigMap as shown in the following example:"
 content: |
 
   {{mdb}}

source/includes/steps-upgrade-om.yaml

@@ -5,7 +5,8 @@ inherit:
   file: steps-upgrade-master.yaml
   ref: upgrade-master-version
 replacement:
-  method: "In your :ref:`k8s-om-specification`, specify the following settings:"
+  method: "In your :ref:`k8s-om-specification`, the settings as shown in the 
+  following example:"
 content: |
 
   {{om}}

source/tutorial/upgrade-mdb-version.txt

@@ -16,13 +16,16 @@ You can upgrade the major, minor, and/or feature compatibility versions
 of your MongoDB resource. These settings are configured in your
 resource's |k8s-configmap|.
 
-- To upgrade your resource's major and/or minor versions, set the
-  :setting:`spec.version` setting to the desired MongoDB version.
+Overview
+-------- 
 
-- To modify your resource's
-  :manual:`feature compatibility version </reference/command/setFeatureCompatibilityVersion/>`,
-  set the :setting:`spec.featureCompatibilityVersion` setting to the
-  desired version.
+To upgrade your resource's major and/or minor versions, set the
+:setting:`spec.version` setting to the desired MongoDB version.
+
+To modify your resource's
+:manual:`feature compatibility version </reference/command/setFeatureCompatibilityVersion/>`,
+set the :setting:`spec.featureCompatibilityVersion` setting to the desired 
+version.
 
 .. note::
 
@@ -34,13 +37,10 @@ resource's |k8s-configmap|.
    To learn more about feature compatibility, see
    :dbcommand:`setFeatureCompatibilityVersion` in the MongoDB Manual.
 
-Prerequisites
--------------
-
 Procedure
 ---------
 
-The following steps upgrade the standalone deployment's MongoDB version to 
-``4.2.2-ent``:
+To upgrade the standalone deployment's MongoDB version to 
+``4.2.2-ent``, complete the following steps:
 
 .. include:: /includes/steps/upgrade-mdb.rst

source/tutorial/upgrade-om-version.txt

@@ -34,7 +34,7 @@ Prerequisites
 Procedure
 ---------
 
-The following example updates |onprem| from 4.0 to 5.0 and the application 
-database to MongoDB ``4.2.11-ent``. 
+To update |onprem| from 4.0 to 5.0 and the application database to MongoDB 
+``4.2.11-ent``, complete the following steps: 
 
 .. include:: /includes/steps/upgrade-om.rst