Merge pull request #78733 from zr-msft/ds-cloud-shell-update

[Dev Spaces] updated troubleshooting step to make it clearer that you…

Author: PRMerger14

articles/dev-spaces/how-to/create-cluster-cloud-shell.md

@@ -12,7 +12,7 @@ keywords: "Docker, Kubernetes, Azure, AKS, Azure Kubernetes Service, containers,
 ---
 # Create a Kubernetes cluster using Azure Cloud Shell
 
-You can use [Azure Cloud Shell](/azure/cloud-shell) to create a cluster for Azure Dev Spaces by using the **Try It** button from this page. If you aren't signed in, follow the prompts to sign in with an Azure account, then type the commands at the Azure Cloud Shell prompt when it appears.
+You can use [Azure Cloud Shell](/azure/cloud-shell) to create an Azure Kubernetes Service cluster by using the **Try It** button from this page. If you aren't signed in, follow the prompts to sign in with an Azure account, then type the commands at the Azure Cloud Shell prompt when it appears.
 
 ## Create the cluster
 
@@ -34,5 +34,8 @@ It takes a few minutes to create the cluster.  When complete, the output is show
 
 See [Azure Dev Spaces](/azure/dev-spaces/) for links to full tutorials.
 
+> [!IMPORTANT]
+> Many of the Azure Dev Spaces quickstarts and tutorials use the Azure Dev Spaces CLI to perform operations. You cannot install the Azure Dev Spaces CLI in the Azure Cloud Shell.
+
 
 [supported-regions]: ../about.md#supported-regions-and-configurations

articles/dev-spaces/troubleshooting.md

@@ -30,24 +30,26 @@ Currently, Azure Dev Spaces works best when debugging a single instance, or pod.
 
 ## Error 'Failed to create Azure Dev Spaces controller'
 
+### Reason
 You might see this error when something goes wrong with the creation of the controller. If it's a transient error, delete and recreate the controller to fix it.
 
-### Try:
+### Try
 
-To delete the controller, use the Azure Dev Spaces CLI. It’s not possible to do it in Visual Studio or Cloud Shell. To install the AZDS CLI, first install the Azure CLI, and then run this command:
+Delete the controller:
 
-```cmd
-az aks use-dev-spaces -g <resource group name> -n <cluster name>
+```bash
+azds remove -g <resource group name> -n <cluster name>
 ```
 
-And then run this command to delete the controller:
+You must use the the Azure Dev Spaces CLI to delete a controller. It’s not possible to delete a controller from Visual Studio. You also cannot install the Azure Dev Spaces CLI in the Azure Cloud Shell so you cannot delete a controller from the Azure Cloud Shell.
+
+If you do not have the Azure Dev Spaces CLI installed, you can first install it using the following command then delete your controller:
 
 ```cmd
-azds remove -g <resource group name> -n <cluster name>
+az aks use-dev-spaces -g <resource group name> -n <cluster name>
 ```
 
-Recreating the controller can be done from the CLI or Visual Studio. Follow the instructions in the tutorials as if starting for the first time.
-
+Recreating the controller can be done from the CLI or Visual Studio. See the [Team development](quickstart-team-development.md) or [Develop with .NET Core](quickstart-netcore-visualstudio.md) quickstarts for examples.
 
 ## Error 'Service cannot be started.'