Merge pull request #235081 from johnmarco/jm-aro-portal-experience-update

Update portal experience

Author: v-dirichards

articles/openshift/media/Basics.png

@@ -5,7 +5,7 @@ author: johnmarco
 ms.author: johnmarc
 ms.service: azure-redhat-openshift
 ms.topic: quickstart
-ms.date: 02/14/2023
+ms.date: 04/19/2023
 ms.custom: mode-ui
 ---
 
@@ -22,52 +22,56 @@ Register the `Microsoft.RedHatOpenShift` resource provider. For instructions on
 
 ## Create an Azure Red Hat OpenShift cluster
 1.	On the Azure portal menu or from the **Home** page, select **All Services** under three horizontal bars on the top left hand page.
-2.	Select **Containers** > **Azure Red Hat OpenShift**.
-3.	On the **Basics** tab, configure the following options:
+2.	Search for and select **Azure Red Hat OpenShift clusters**.
+3.  Select **Create**.
+4.	On the **Basics** tab, configure the following options:
     * **Project details**:
-        *	Select an **Azure Subscription**.
-        *	Select or create an **Azure Resource group**, such as *myResourceGroup*.
-    * **Cluster details**:
+        *	Select an Azure **Subscription**.
+        *	Select or create an Azure **Resource group**, such as *myResourceGroup*.
+    * **Instance details**:
         * Select a **Region** for the Azure Red Hat OpenShift cluster.
-        *	Enter a OpenShift **cluster name**, such as *myAROCluster*.
-        *	Enter **Domain name**.
+        *	Enter an **OpenShift cluster name**, such as *myAROCluster*.
+        *	Enter a **Domain name**.
         *	Select **Master VM Size** and **Worker VM Size**.
+        *   Select **Worker node count** (i.e., the number of worker nodes to create). 
 
-    ![**Basics** tab on Azure portal](./media/Basics.png)
+     > [!div class="mx-imgBorder"]
+     > [ ![**Basics** tab on Azure portal](./media/Basics.png) ](./media/Basics.png#lightbox)
 
     > [!NOTE]
-    > In the **Domain name** field, you can either specify a domain name (e.g., *example.com*) or a prefix (e.g., *abc*) that will be used as part of the auto-generated DNS name for OpenShift console and API servers. This prefix is also used as part of the name of the resource group (e.g., *aro-abc*) that is created to host the cluster VMs.
+    > The **Domain name** field is pre-populated with a random string. You can either specify a domain name (e.g., *example.com*) or a string/prefix (e.g., *abc*) that will be used as part of the auto-generated DNS name for OpenShift console and API servers. This prefix is also used as part of the name of the resource group that is created to host the cluster VMs if a resource group name is not specified.
 
-4. On the **Authentication** tab of the **Azure Red Hat OpenShift** dialog, complete the following sections.
+5. On the **Authentication** tab, complete the following sections.
 
-    In the **Service principal information** section:
+    Under **Service principal information**, select either **Create new** or **Existing**. If you choose to use an existing service principal, enter the following information:
 
    - **Service principal client ID** is your appId. 
    - **Service principal client secret** is the service principal's decrypted Secret value.
 
-    If you need to create a service principal, see  [Creating and using a service principal with an Azure Red Hat OpenShift cluster](howto-create-service-principal.md).
+    > [!NOTE]
+    > If you need to create a service principal, see  [Creating and using a service principal with an Azure Red Hat OpenShift cluster](howto-create-service-principal.md).
     
-   In the **Cluster pull secret** section:
-
-   - **Pull secret** is your cluster's pull secret's decrypted value. If you don't have a pull secret, leave this field blank.
+   Under **Pull secret**, enter the **Red Hat pull secret** (i.e., your cluster's pull secret's decrypted value). If you don't have a pull secret, leave this field blank.
 
    :::image type="content" source="./media/openshift-service-principal-portal.png" alt-text="Screenshot that shows how to use the Authentication tab with Azure portal to create a service principal." lightbox="./media/openshift-service-principal-portal.png":::
 
-5.	On the **Networking** tab, which follows, make sure to configure the required options.
+6.	On the **Networking** tab, configure the required options.
 
-   **Note**: Azure Red Hat OpenShift clusters running OpenShift 4 require a virtual network with two empty subnets: one for the control plane and one for worker nodes.
+       **Note**: Azure Red Hat OpenShift clusters running OpenShift 4 require a virtual network with two empty subnets: one for the control plane and one for worker nodes.
 
-![**Networking** tab on Azure portal](./media/Networking.png)
+> [!div class="mx-imgBorder"]
+> [ ![**Networking** tab on Azure portal](./media/Networking.png) ](./media/Networking.png#lightbox)
 
-6.	On the **Tags** tab, add tags to organize your resources.
+7.	On the **Tags** tab, add tags to organize your resources.
 
-![**Tags** tab on Azure portal](./media/Tags.png)
+> [!div class="mx-imgBorder"]
+> [ ![**Tags** tab on Azure portal](./media/Tags.png) ](./media/Tags.png#lightbox)
  
-7.	Check **Review + create** and then **Create** when validation completes.   
+8.	Check **Review + create** and then **Create** when validation completes.   
 
 ![**Review + create** tab on Azure portal](./media/Review+Create.png)
 
-8.	It takes approximately 35 to 45 minutes to create the Azure Red Hat OpenShift cluster. When your deployment is complete, navigate to your resource by either:
+9.	It takes approximately 35 to 45 minutes to create the Azure Red Hat OpenShift cluster. When your deployment is complete, navigate to your resource by either:
     *	Clicking **Go to resource**, or
     *	Browsing to the Azure Red Hat OpenShift cluster resource group and selecting the Azure Red Hat OpenShift resource.
-        *	Per example cluster dashboard below: browsing for *myResourceGroup* and selecting *myAROCluster* resource.
+        *	Per example cluster dashboard below: browsing for *myResourceGroup* and selecting *myAROCluster* resource.