Update based on Mark V's feedback

Author: mattbriggs

articles/virtual-machines/linux/openshift-azure-stack.md

@@ -1,31 +1,35 @@
 ---
-title: Deploy OpenShift in Azure Stack Hub 
-description: Deploy OpenShift in Azure Stack Hub.
-author: haroldwongms
-manager: joraio
+title: Deploy OpenShift to Azure Stack Hub 
+description: Deploy OpenShift to Azure Stack Hub.
+author: mattbriggs
+manager: femila
+ms.author: mabrigg
 ms.service: virtual-machines
 ms.subservice: openshift
 ms.collection: linux
-ms.topic: how-to
+ms.topic: conceptual
 ms.workload: infrastructure
-ms.date: 10/14/2019
-ms.author: haroldw
+ms.date: 11/19/2021
+
 ---
 
-# Deploy OpenShift Container Platform or OKD in Azure Stack Hub
+# Deploy OpenShift Container Platform or OKD to Azure Stack Hub
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Flexible scale sets 
 
 [OpenShift](openshift-get-started.md) can be deployed in Azure Stack Hub. There are some key differences between Azure and Azure Stack Hub so deployment will differ slightly and capabilities will also differ slightly.
 
-Currently, the Azure Cloud Provider doesn't work in Azure Stack Hub. For this reason, you won't be able to use disk attach for persistent storage in Azure Stack Hub. Instead, you can configure other storage options such as NFS, iSCSI, and GlusterFS. As an alternative, you can enable CNS and use GlusterFS for persistent storage. If CNS is enabled, three more nodes will be deployed with storage for GlusterFS usage.
+Currently, the Azure Cloud Provider doesn't work in Azure Stack Hub. You won't be able to use disk attach for persistent storage in Azure Stack Hub. Instead, you can configure other storage options such as NFS, iSCSI, and GlusterFS. Or, you can enable CNS and use GlusterFS for persistent storage. If CNS is enabled, three more nodes will be deployed with storage for GlusterFS usage.
+
+## Deploy OpenShift 3.x On Azure Stack Hub
 
 You can use one of several methods to deploy OpenShift Container Platform or OKD in Azure Stack Hub:
 
 - You can manually deploy the necessary Azure infrastructure components and then follow the [OpenShift Container Platform documentation](https://docs.openshift.com/container-platform) or [OKD documentation](https://docs.okd.io).
 - You can also use an existing [Azure Resource Manager template](https://github.com/Microsoft/openshift-container-platform/) that simplifies the deployment of the OpenShift Container Platform cluster.
+- You can also use an existing [Azure Resource Manager template](https://github.com/Microsoft/openshift-origin) that simplifies the deployment of the OKD cluster.
 
-If using the Azure Resource Manager template, select the proper branch (`azurestack-release-3.x`). The templates for Azure won't work. The API versions are different between Azure and Azure Stack Hub. The RHEL (Red Hat Enterprise Linux) image reference is currently hard-coded as a variable in the `azuredeploy.json` file and you will need to update to match your image.
+If using the Azure Resource Manager template, select the proper branch (azurestack-release-3.x). The templates for Azure won't work as the API versions are different between Azure and Azure Stack Hub. The RHEL image reference is currently hard-coded as a variable in the azuredeploy.json file and will need to be changed to match your image.
 
 ```json
 "imageReference": {
@@ -36,39 +40,36 @@ If using the Azure Resource Manager template, select the proper branch (`azurest
 }
 ```
 
-## Prerequisites
-
-You or your cloud operator will need to have the following things to deploy OpenShift on Azure Stack Hub.
-
-### A Red Hat subscription
+For all options, a Red Hat subscription is required. During the deployment, the Red Hat Enterprise Linux instance is registered to the Red Hat subscription and attached to the Pool ID that contains the entitlements for OpenShift Container Platform.
+Make sure you have a valid Red Hat Subscription Manager (RHSM) username, password, and Pool ID. Alternatively, you can use an Activation Key, Org ID, and Pool ID.  You can verify this information at https://access.redhat.com.
 
-A Red Hat subscription is required. During the deployment, the RHEL instance is registered to the Red Hat subscription and attached to the Pool ID that contains the entitlements for OpenShift Container Platform.
+### Azure Stack Hub prerequisites
 
-Make sure you have a valid Red Hat Subscription Manager (RHSM) username, password, and Pool ID. Alternatively, you can use an Activation Key, Org ID, and Pool ID.  You can verify this information by at https://access.redhat.com.
+An RHEL image (OpenShift Container Platform) or CentOS image (OKD) needs to be added to your Azure Stack Hub environment to deploy an OpenShift cluster. Contact your Azure Stack Hub cloud operator to add these images. Instructions can be found here:
 
-### Red Hat Enterprise Linux CoreOS (RHCOS) 4.9 available in Azure Stack Hub
+- [Add and remove a custom VM image to Azure Stack Hub](/azure-stack/operator/azure-stack-add-vm-image)
+- [Azure Marketplace items available for Azure Stack Hub](/azure-stack/operator/azure-stack-marketplace-azure-items)
+- [Offer a Red Hat-based virtual machine for Azure Stack Hub](/azure-stack/operator/azure-stack-redhat-create-upload-vhd)
 
-Red Hat Enterprise Linux CoreOS (RHCOS) 4.9 is not available in the Azure Stack Hub Marketplace. Your cloud operator doesn't need to create an marketplace offering for the RHEL CoreOS 4.9, but the image does not need to be available.
-
-The cloud operator for your Azure Stack Hub instance will need to get the .VHD from Red Hat and load it into a storage container in the Azure Stack Hub environment. Then, the operator can reference the VHD location in the Azure Resource Manager template used to deploy OpenShift. The image is used for deployment and will be used for all control plane. The image can also be used for worker nodes in the cluster. You can also the image or Red Hat Enterprise Linux (RHEL) 7.9 or 8.4 images for worker nodes.
-
-The operator can follow the steps in the Open Shift documentation at:
-1. [Uploading the RHCOS cluster image and bootstrap Ignition config file](https://docs.openshift.com/container-platform/4.9/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.html#installation-azure-user-infra-uploading-rhcos_installing-azure-stack-hub-user-infra)
-2. [Deploying the RHCOS cluster image for the Azure Stack Hub infrastructure](https://docs.openshift.com/container-platform/4.9/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.html#installation-azure-user-infra-deploying-rhcos_installing-azure-stack-hub-user-infra)
-
-Contact your Azure Stack Hub cloud operator to add this image using these instructions.
-## Deploy by using the OpenShift Container Platform or OKD Resource Manager template
+### Deploy by using the OpenShift Container Platform or OKD Azure Resource Manager template
 
 To deploy by using the Azure Resource Manager template, you use a parameters file to supply the input parameters. To further customize the deployment, fork the GitHub repo and change the appropriate items.
 
 Some common customization options include, but aren't limited to:
 
-- Bastion VM size (variable in azuredeploy.json)
-- Naming conventions (variables in azuredeploy.json)
-- OpenShift cluster specifics, modified via hosts file (deployOpenShift.sh)
-- RHEL image reference (variable in azuredeploy.json)
+- Bastion VM size (variable in `azuredeploy.json`)
+- Naming conventions (variables in` azuredeploy.json`)
+- OpenShift cluster specifics, modified via hosts file (`deployOpenShift.sh`)
+- RHEL image reference (variable in `azuredeploy.json`)
 
 For the steps to deploy using the Azure CLI, follow the appropriate section in the [OpenShift Container Platform](./openshift-container-platform-3x.md) section or the [OKD](./openshift-okd.md) section.
+## Deploy OpenShift 4.x On Azure Stack Hub
+
+Red Hat manages the Red Hat Enterprise Linux CoreOS (RHCOS) for OpenShift 4.x. The deployment process gets the image from a Red Hat endpoint. As a result, the user (tenant) doesn't need to get an image from the Azure Stack hub Marketplace.
+
+You can follow the steps in the Open Shift documentation at:
+1. [Uploading the RHCOS cluster image and bootstrap Ignition config file](https://docs.openshift.com/container-platform/4.9/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.html#installation-azure-user-infra-uploading-rhcos_installing-azure-stack-hub-user-infra)
+2. [Deploying the RHCOS cluster image for the Azure Stack Hub infrastructure](https://docs.openshift.com/container-platform/4.9/installing/installing_azure_stack_hub/installing-azure-stack-hub-user-infra.html#installation-azure-user-infra-deploying-rhcos_installing-azure-stack-hub-user-infra)
 
 ## Next steps