Simplify codespaces steps

Author: kgremban

articles/iot-operations/get-started/quickstart-deploy.md

@@ -137,9 +137,9 @@ This script automates the following steps:
 
 * Create the Azure resource group in your Azure subscription to store all the resources.
 
-* Connect the cluster to Azure Arc and registers the required Azure resource providers.
+* Connect the cluster to Azure Arc and register the required Azure resource providers.
 
-* Apply all the required configurations for Azure IoT Operations, including:
+* Apply all of the required configurations for Azure IoT Operations, including:
 
   * Enable a firewall rule and port forwarding for port 8883 to enable incoming connections to Azure IoT Operations  broker.
 

articles/iot-operations/includes/connect-cluster.md

@@ -23,29 +23,23 @@ To connect your cluster to Azure Arc:
    > * Open the codespace in VS Code desktop, and then return to the browser terminal and rerun `az login`.
    > * Or, after you get the localhost error on the browser, copy the URL from the browser and run `curl "<URL>"` in a new terminal tab. You should see a JSON response with the message "You have logged into Microsoft Azure!."
 
-1. Set an environment variable for the cluster name as it will show up in your resource group.
+1. Set environment variables for your Azure subscription, location, a new resource group, and the cluster name as it will show up in your resource group.
 
-   ```bash
-   # Name of the Arc-enabled cluster to create in your resource group
-   export CLUSTER_NAME=<NEW_CLUSTER_NAME>
-   ```
-
-1. Set environment variables for your Azure subscription, location, and a new resource group. If you're using GitHub Codespaces and set these secrets when creating your codespace, you can skip this step.
+   If you're using GitHub Codespaces and set up these values as recommended secrets when creating your codespace, skip this step. The codespace automatically sets the cluster name to be the same as the codespace name.
 
    ```bash
    # Id of the subscription where your resource group and Arc-enabled cluster will be created
    export SUBSCRIPTION_ID=<SUBSCRIPTION_ID>
-   ```
 
-   ```bash
    # Azure region where the created resource group will be located
    # Currently supported regions: "eastus", "eastus2", "westus", "westus2", "westus3", "westeurope", or "northeurope"
    export LOCATION=<REGION>
-   ```
 
-   ```bash
    # Name of a new resource group to create which will hold the Arc-enabled cluster and Azure IoT Operations resources
    export RESOURCE_GROUP=<NEW_RESOURCE_GROUP_NAME>
+
+   # Name of the Arc-enabled cluster to create in your resource group
+   export CLUSTER_NAME=<NEW_CLUSTER_NAME>
    ```
 
 1. Set the Azure subscription context for all commands:
@@ -56,6 +50,9 @@ To connect your cluster to Azure Arc:
 
 1. Register the required resource providers in your subscription:
 
+   >[!NOTE]
+   >This step only needs to be run once per subscription.
+
    ```azurecli
    az provider register -n "Microsoft.ExtendedLocation"
    az provider register -n "Microsoft.Kubernetes"

articles/iot-operations/includes/prepare-codespaces.md

@@ -26,14 +26,17 @@ To get started with your codespace:
 
    [![Create an explore-iot-operations codespace](https://github.com/codespaces/badge.svg)](https://codespaces.new/Azure-Samples/explore-iot-operations?quickstart=1)
 
-   You don't have to provide the recommended secrets at this step. If you do, they get saved on your GitHub account to be used in this and future codespaces. They're also added as environment variables in the codespace terminal, and you don't have to run the CLI commands in the next section that configure the subscription, resource group, or location variables.
+1. Provide the following recommended secrets for your codespace:
 
    | Parameter | Value |
    | --------- | ----- |
    | SUBSCRIPTION_ID | Your Azure subscription ID. |
    | RESOURCE_GROUP | A name for a new Azure resource group where your cluster will be created. |
    | LOCATION | An Azure region close to you. The following regions are supported in public preview: eastus, eastus2, westus, westus2, westus3, westeurope, or northeurope. |
 
+   >[!TIP]
+   > The values you provide as secrets in this step get saved on your GitHub account to be used in this and future codespaces. They're also automatically added as environment variables in the codespace terminal, and you can use those environment variables in the CLI commands in the next section.
+
 1. Select **Create new codespace**.
 
 1. Once the codespace is ready, select the menu button at the top left, then select **Open in VS Code Desktop**.