[#161571101] additional clarifications about stemcell, textsmithing

_add-clusters-workloads.html.md.erb

@@ -1,3 +1,4 @@
+
 Verify that the PKS control plane remains functional by performing the following steps:
     1. Add more workloads and create an additional cluster. For more information about performing those actions, see
 <a href="maintain-uptime.html#upgrades">About Workload Upgrades</a> in _Maintaining Workload Uptime_ and

understanding-upgrades.html.md.erb

@@ -83,3 +83,4 @@ For more information, see [Upgrade the PKS Tile](upgrade-pks.html#upgrade-tile)
 For more information about the PKS control plane, see [PKS Control Plane Overview](control-plane.html#control-plane) in _PKS Cluster Management_.
 
 <p class="note"><strong>Note</strong>: When PKS is set to upgrade only the PKS tile and not the clusters, the Kubernetes cluster version falls behind the PKS tile version. If the clusters fall more than one version behind the tile, PKS cannot upgrade the clusters. The clusters must be upgraded to match the PKS tile version before the next tile upgrade.</p>
+

upgrade-pks-nsxt.html.md.erb

@@ -132,9 +132,11 @@ To upgrade to NSX-T v2.2, follow the procedures detailed in [Upgrading NSX-T](ht
 
 ### <a id="upgrade-opsman"></a> Step 3: Upgrade to Ops Manager v2.2.2+ or v2.3.1+
 
-Follow the procedures detailed in [Upgrade Ops Manager and Installed Products to v2.2](https://docs.pivotal.io/pivotalcf/2-2/customizing/upgrading-pcf.html#upgrade_ops) or [Upgrade Ops Manager and Installed Products to v2.3](https://docs.pivotal.io/pivotalcf/2-3/customizing/upgrading-pcf.html#upgrade_ops).
+Before you upgrade to PKS v1.2.x, you must upgrade to Ops Manager v2.2.2+ or v2.3.1+.
+
+1. Follow the procedures detailed in [Upgrade Ops Manager and Installed Products to v2.2](https://docs.pivotal.io/pivotalcf/2-2/customizing/upgrading-pcf.html#upgrade_ops) or [Upgrade Ops Manager and Installed Products to v2.3](https://docs.pivotal.io/pivotalcf/2-3/customizing/upgrading-pcf.html#upgrade_ops).
 
-<%= partial 'add-clusters-workloads' %>
+1. <%= partial 'add-clusters-workloads' %>
 
 ### <a id="upgrade-pks"></a> Step 4: Upgrade to PKS v1.2.x
 
@@ -156,29 +158,41 @@ Follow the steps below to perform an upgrade.
 1. Under the **Import a Product** button, click **+** next to **Pivotal Container Service**. This adds the tile to your staging area.<br><br>
   <img src="images/upgrade-nsxt-3.png" alt="Import the PKS product file">
 
-1. (Optional) If the stemcell is not current, click the **Missing stemcell** link and follow the steps below:
-  <img src="images/upgrade-nsxt-4.png" alt="Verify successful import of PKS">
+### <a id="stemcell"></a> Step 5: Download and Import the Stemcell
 
-  1. In the **Stemcell Library**, locate Pivotal Container Service and note the required stemcell version.
+PKS v1.2.x uses a [Xenial stemcell](https://docs.pivotal.io/pivotalcf/2-3/stemcells/#xenial). 
 
-  1. Visit the [Stemcells for PCF (Ubuntu Xenial)](https://network.pivotal.io/products/stemcells-ubuntu-xenial/) page on Pivotal Network, 
+If Ops Manager does not have the Xenial stemcell required for PKS, the PKS tile displays the message **Missing stemcell**. 
+
+<p class="note"><strong>Note:</strong> If the <b>Stemcell Library</b> in Ops Manager already has a compatible Xenial stemcell, 
+  the <b>Missing stemcell</b> link does not appear. You do not need to download or import a new stemcell and can skip this step.</p>
+
+To download and import a new Xenial stemcell, follow the steps below:
+
+1. On the **Pivotal Container Service** tile, click on the **Missing stemcell** link.
+
+    <img src="images/missing_stemcell.png" alt="Verify stemcell assignment">
+
+1. In the **Stemcell Library**, locate Pivotal Container Service and note the required stemcell version.
+
+1. Visit the [Stemcells for PCF (Ubuntu Xenial)](https://network.pivotal.io/products/stemcells-ubuntu-xenial/) page on Pivotal Network, 
 and download the required stemcell version for vSphere.
 
-  1. Return to the **Installation Dashboard** in Ops Manager, and click on **Stemcell Library**.
+1. Return to the **Installation Dashboard** in Ops Manager, and click on **Stemcell Library**.
 
-  1. On the **Stemcell Library** page, click **Import Stemcell** and select the stemcell file you downloaded from Pivotal Network.
+1. On the **Stemcell Library** page, click **Import Stemcell** and select the stemcell file you downloaded from Pivotal Network.
     <img src="images/upgrade-nsxt-5.png" alt="Import stemcell">
 
-  1. Select the PKS product and click **Apply Stemcell to Products**.
+1. Select the PKS product and click **Apply Stemcell to Products**.
     <img src="images/upgrade-nsxt-6.png" alt="Apply stemcell to PKS">
 
-  1. Verify that Ops Manager successfully applied the stemcell.
+1. Verify that Ops Manager successfully applied the stemcell.
     <img src="images/upgrade-nsxt-7.png" alt="Verify stemcell assignment">
 
-  1. Select the **Installation Dashboard** link to return to the Installation Dashboard.
+1. Select the **Installation Dashboard** link to return to the Installation Dashboard.
     <img src="images/upgrade-nsxt-8.png" alt="Verify status is green">
 
-### <a id="worker-nodes"></a> Step 5: Verify Errand Configuration
+### <a id="worker-nodes"></a> Step 6: Verify Errand Configuration
 
 To verify that errands are configured correctly in the PKS tile, perform the following steps.
 

upgrade-pks.html.md.erb

@@ -17,6 +17,8 @@ For information about upgrading PKS on vSphere with NSX-T integration, see
 
 ## <a id="before"></a>Before You Upgrade
 
+This section describes the activities you must perform before upgrading PKS.
+
 ### <a id="upgrade-path"></a> Determine Your Upgrade Path
 
 Use the following table to determine your upgrade path to PKS v1.2.x. 
@@ -102,7 +104,11 @@ Your configuration settings migrate to the new version automatically. Follow the
 PKS v1.2.x uses a [Xenial stemcell](https://docs.pivotal.io/pivotalcf/2-3/stemcells/#xenial). 
 
 If Ops Manager does not have the Xenial stemcell required for PKS, the PKS tile displays the message **Missing stemcell**. 
-You must download and import a new stemcell. Follow the steps below:
+
+<p class="note"><strong>Note:</strong> If the <b>Stemcell Library</b> in Ops Manager already has a compatible Xenial stemcell, 
+  the <b>Missing stemcell</b> link does not appear. You do not need to download or import a new stemcell and can skip this step.</p>
+
+To download and import a new Xenial stemcell, follow the steps below:
 
 1. On the **Pivotal Container Service** tile, click on the **Missing stemcell** link.