Merge pull request #106422 from philon-msft/master

Consistency improvements in Dev Spaces docs

Author: American-Dipper

articles/dev-spaces/how-to/dev-spaces-business-continuity.md

@@ -21,11 +21,9 @@ Enabling Dev Spaces on AKS clusters in different regions allows you to resume us
 
 For general information about multi-region deployments of AKS, see [Plan for multi-region deployment](https://docs.microsoft.com/azure/aks/operator-best-practices-multi-region#plan-for-multiregion-deployment)
 
-For information about deploying an AKS cluster that is compatible with Azure Dev Spaces, see [Create a Kubernetes cluster using Azure Cloud Shell](https://docs.microsoft.com/azure/dev-spaces/how-to/create-cluster-cloud-shell)
-
 ### Enable Dev Spaces via the Azure portal
 
-Click the **Dev Spaces** navigation item under the properties of each cluster in the Azure portal. Then choose the option to enable Dev Spaces.
+Select the **Dev Spaces** menu item under the settings of each cluster in the Azure portal. Then choose the option to enable Dev Spaces and save.
 
 ![Enabling Dev Spaces via Azure portal](../media/common/enable-dev-spaces.jpg)
 
@@ -47,7 +45,7 @@ You should deploy the most recent versions of your baseline set of services to c
 
 ## Select the correct AKS cluster to use for Dev Spaces
 
-Once you've properly configured a backup cluster running your team's baseline, you can quickly switch over to the backup cluster at any time. Then you can rerun the individual services that you are working on in Dev Spaces.
+Once you've properly configured a backup cluster running your team's baseline, you can quickly switch over to the backup cluster at any time. Then you can rerun the individual services that you are working on in child dev spaces.
 
 Select a different cluster with the following CLI command:
 

articles/dev-spaces/how-to/install-dev-spaces.md

@@ -1,19 +1,19 @@
 ---
-title: "Install Azure Dev Spaces on AKS & the client-side tooling"
+title: "Enable Azure Dev Spaces on AKS & install the client-side tools"
 services: azure-dev-spaces
 ms.date: "07/24/2019"
 ms.topic: "conceptual"
-description: "Learn how to install Azure Dev Spaces on an AKS cluster and install the client-side tooling."
+description: "Learn how to enable Azure Dev Spaces on an AKS cluster and install the client-side tools."
 keywords: "Docker, Kubernetes, Azure, AKS, Azure Kubernetes Service, containers, Helm, service mesh, service mesh routing, kubectl, k8s"
 ---
 
-# Install Azure Dev Spaces on AKS and the client-side tooling
+# Enable Azure Dev Spaces on an AKS cluster and install the client-side tools
 
-This article shows you several ways to install Azure Dev Spaces on an AKS cluster as well as install the client-side tooling.
+This article shows you several ways to enable Azure Dev Spaces on an AKS cluster as well as install the client-side tools.
 
-## Install Azure Dev Spaces using the CLI
+## Enable Azure Dev Spaces using the CLI
 
-Before you can install Dev Spaces using the CLI, you need:
+Before you can enable Dev Spaces using the CLI, you need:
 * An Azure subscription. If you don't have an Azure subscription, you can create a [free account][az-portal-create-account].
 * [The Azure CLI installed][install-cli].
 * [An AKS cluster][create-aks-cli] in a [supported region][supported-regions].
@@ -44,25 +44,25 @@ Managed Kubernetes cluster 'myAKSCluster' in resource group 'myResourceGroup' is
 
 The `use-dev-spaces` command also installs the Azure Dev Spaces CLI.
 
-## Install Azure Dev Spaces using the Azure portal
+## Enable Azure Dev Spaces using the Azure portal
 
-Before you can install Dev Spaces using the Azure portal, you need:
+Before you can enable Dev Spaces using the Azure portal, you need:
 * An Azure subscription. If you don't have an Azure subscription, you can create a [free account][az-portal-create-account].
 * [An AKS cluster][create-aks-portal] in a [supported region][supported-regions].
 
-To install Azure Dev Spaces using the Azure portal:
+To enable Azure Dev Spaces using the Azure portal:
 1. Sign in to the [Azure portal][az-portal].
 1. Navigate to your AKS cluster.
-1. Click *Dev Spaces*.
+1. Select the *Dev Spaces* menu item.
 1. Change *Enable Dev Spaces* to *Yes* and click *Save*.
 
 ![Enable Dev Spaces in the Azure portal](../media/how-to-setup-dev-spaces/enable-dev-spaces-portal.png)
 
-Installing Azure Dev Spaces using the Azure portal **does not** install any client-side tooling for Azure Dev Spaces.
+Enabling Azure Dev Spaces using the Azure portal **does not** install any client-side tools for Azure Dev Spaces.
 
-## Install the client-side tooling
+## Install the client-side tools
 
-You can use the Azure Dev Spaces client-side tooling to interact with dev spaces on an AKS cluster from your local machine. There are several ways to install the client-side tooling:
+You can use the Azure Dev Spaces client-side tools to interact with dev spaces on an AKS cluster from your local machine. There are several ways to install the client-side tools:
 
 * In [Visual Studio Code][vscode], install the [Azure Dev Spaces extension][vscode-extension].
 * In [Visual Studio 2019][visual-studio], install the Azure Development workload.