refining

Author: kgremban

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

@@ -34,11 +34,11 @@ The following quickstarts in this series build on this one to define sample asse
 
 This series of quickstarts is intended to help you get started with Azure IoT Operations as quickly as possible so that you can evaluate an end-to-end scenario. In a true development or production environment, these tasks would be performed by multiple teams working together and some tasks might require elevated permissions.
 
-For the best new user experience, we recommend using an [Azure free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) so that you have owner permissions over the resources in these quickstarts. We also recommend using GitHub Codespaces as a virtual environment in which you can quickly begin deploying resources and running commands without installing new tools on your own machines.
+For the best new user experience, we recommend using an [Azure free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) so that you have owner permissions over the resources in these quickstarts. We also provide steps to use GitHub Codespaces as a virtual environment in which you can quickly begin deploying resources and running commands without installing new tools on your own machines.
 
 ## Prerequisites
 
-For this quickstart, you create a Kubernetes cluster to receive the Azure IoT Operations deployment. We recommend using GitHub Codespaces to host the cluster as a quick way to get started without installing new tools.
+For this quickstart, you create a Kubernetes cluster to receive the Azure IoT Operations deployment.
 
 If you want to rerun this quickstart with a cluster that already has Azure IoT Operations deployed to it, refer to the steps in [Clean up resources](#clean-up-resources) to uninstall Azure IoT Operations before continuing.
 
@@ -54,7 +54,7 @@ Before you begin, prepare the following prerequisites:
 
 Azure IoT Operations is a suite of data services that run on Kubernetes clusters. You want these clusters to be managed remotely from the cloud, and able to securely communicate with cloud resources and endpoints. We address these concerns with the following tasks in this quickstart:
 
-1. Connect a Kubernetes cluster to Azure Arc for remote management.
+1. Create a Kubernetes cluster and connect it to Azure Arc for remote management.
 1. Create an Azure Key Vault to manage secrets for your cluster.
 1. Configure your cluster with a secrets store and service principal to communicate with cloud resources.
 1. Deploy Azure IoT Operations to your cluster.
@@ -145,7 +145,7 @@ If you want to delete the Azure IoT Operations deployment but plan on reinstalli
 
 1. In your resource group in the Azure portal, select your cluster.
 1. On your cluster resource page, select **Extensions**.
-1. Select all of the extensions of type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. You don't need to uninstall the secrets provider extension:
+1. Select all of the extensions of type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. Don't uninstall the secrets provider extension.
 
     :::image type="content" source="media/quickstart-deploy/uninstall-extensions.png" alt-text="Screenshot that shows the extensions to uninstall.":::
 

articles/iot-operations/get-started/quickstart-upload-telemetry-to-cloud.md

@@ -80,7 +80,7 @@ Create a lakehouse in your Microsoft Fabric workspace:
 
 Your codespace comes with the following sample connector configuration file, `/workspaces/explore-iot-operations/samples/quickstarts/datalake-connector.yaml`:
 
-    :::code language="yaml" source="~/azure-iot-operations-samples/samples/quickstarts/datalake-connector.yaml":::
+:::code language="yaml" source="~/azure-iot-operations-samples/samples/quickstarts/datalake-connector.yaml":::
 
 1. Open the _datalake-connector.yaml_ file in a text editor and replace `<your-workspace-name>` with the name of your Microsoft Fabric workspace. You made a note of this value when you created the workspace.
 

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

@@ -20,7 +20,7 @@ Use GitHub Codespaces to try Azure IoT Operations on a Kubernetes cluster withou
 > [!IMPORTANT]
 > Codespaces are easy to set up quickly and tear down later, but they're not suitable for performance evaluation or scale testing. Use GitHub Codespaces for exploration only.
 
-To get started with your codespace:
+To create your codespace and cluster, use the following steps:
 
 1. Create a codespace in GitHub Codespaces.