Explain role of codespace secrets

Author: kgremban

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

@@ -23,7 +23,14 @@ 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 environment variables for the rest of the setup. Replace values in `<>` with valid values or names of your choice. A new cluster and resource group are created in your Azure subscription based on the names you provide:
+1. Set an environment variable for 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.
 
    ```bash
    # Id of the subscription where your resource group and Arc-enabled cluster will be created
@@ -41,11 +48,6 @@ To connect your cluster to Azure Arc:
    export RESOURCE_GROUP=<NEW_RESOURCE_GROUP_NAME>
    ```
 
-   ```bash
-   # 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:
 
    ```azurecli

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

@@ -26,7 +26,13 @@ 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, make sure that you use the same values here and in the CLI commands in the next section.
+   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.
+
+   | 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. |
 
 1. Select **Create new codespace**.