made changes in accordance with the Azure CLI article and editor's guidelines documentation

Author: cebundy

articles/azure-web-pubsub/includes/cli-awps-connstr.md

@@ -9,10 +9,10 @@ ms.author: lianwei
 > [!INPORTANT]
 > A connection string includes the authorization information required for your application to access Azure Web PubSub service. The access key inside the connection string is similar to a root password for your service. In production environments, always be careful to protect your access keys. Use Azure Key Vault to manage and rotate your keys securely. Avoid distributing access keys to other users, hard-coding them, or saving them anywhere in plain text that is accessible to others. Rotate your keys if you believe they may have been compromised.
 
-Use the Azure CLI [az webpubsub key](/cli/azure/webpubsub#az-webpubsub-key) command to get the **ConnectionString** of the service.  Replace the `<your-unique-resource-name>` with the name of your Azure Web PubSub instance.
+Use the Azure CLI [az webpubsub key](/cli/azure/webpubsub#az-webpubsub-key) command to get the **ConnectionString** of the service.  Replace the `<your-unique-resource-name>` placeholder with the name of your Azure Web PubSub instance.
 
 ```azurecli
-az webpubsub key show --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --query primaryConnectionString --output tsv
+az webpubsub key show --resource-group myResourceGroup --name <your-unique-resource-name> --query primaryConnectionString --output tsv
 ```
 
 Copy the connection string to use later.

articles/azure-web-pubsub/includes/cli-awps-setup.md

@@ -9,7 +9,9 @@ ms.custom: devx-track-azurecli
 
 ## Azure CLI setup for local development
 
-Follow these steps to set up the Azure CLI and your project environment.
+Follow these steps to set up Azure CLI and your project environment.
+
+1. Open a command shell.
 
 1. Upgrade to the latest version of the Azure CLI.
 
@@ -23,14 +25,9 @@ Follow these steps to set up the Azure CLI and your project environment.
     az extension add --name webpubsub
     ```
 
-1. Sign in to the Azure CLI.  Following the prompts, enter your Azure credentials.
+1. Sign in to Azure CLI.  Following the prompts, enter your Azure credentials.
 
     ```azurecli
     az login
     ```
 
-1. Create a resource group.
-
-    ```azurecli
-    az group create --name myResourceGroup --location eastus
-    ```

articles/azure-web-pubsub/includes/cli-rg-creation.md

@@ -6,8 +6,8 @@ ms.date: 08/06/2021
 ms.author: lianwei
 ---
 
-A resource group is a logical container into which Azure resources are deployed and managed. Use the [az group create](/cli/azure/group#az-group-create) command to create a resource group named *myResourceGroup* in the *eastus* location.
+A resource group is a logical container into which Azure resources are deployed and managed. Use the [az group create](/cli/azure/group#az-group-create) command to create a resource group named `myResourceGroup` in the `eastus` location.
 
 ```azurecli
-az group create --name "myResourceGroup" -l "EastUS"
+az group create --name myResourceGroup --location EastUS
 ```

articles/azure-web-pubsub/tutorial-pub-sub-messages.md

@@ -22,8 +22,7 @@ In this tutorial, you learn how to:
 
 [!INCLUDE [azure-web-pubsub-tutorial-prerequisites](includes/cli-awps-prerequisites.md)]
 
->[!NOTE]
-> You can use the Windows cmd.exe command shell instead of a bash shell to run the commands in this tutorial.
+You can use the Windows cmd.exe command shell instead of a Bash shell to run the commands in this tutorial.
 
 If creating the project on a local machine, you'll need to install the dependencies for the language you're using:
 
@@ -46,7 +45,7 @@ If creating the project on a local machine, you'll need to install the dependenc
 
 ---
 
-## Setup
+## Prepare your environment
 
 # [Local Azure CLI](#tab/LocalBash)
 
@@ -58,7 +57,7 @@ If creating the project on a local machine, you'll need to install the dependenc
 
 ---
 
-### Create a resource group
+## Create a resource group
 
 [!INCLUDE [Create a resource group](includes/cli-rg-creation.md)]
 
@@ -69,18 +68,17 @@ If creating the project on a local machine, you'll need to install the dependenc
 
 ### Create a Web PubSub instance
 
-Use the Azure CLI [az webpubsub create](/cli/azure/webpubsub#az-webpubsub-create) command to create a Web PubSub in the resource group you've created. The following command creates a _Free_ Web PubSub resource under resource group *myResourceGroup* in *EastUS*:
+Use the Azure CLI [az webpubsub create](/cli/azure/webpubsub#az-webpubsub-create) command to create a Web PubSub in the resource group you've created. The following command creates a _Free_ Web PubSub resource under resource group `myResourceGroup` in `EastUS`:
 
-  > [!Important]
-  > Each Web PubSub resource must have a unique name. Replace <your-unique-resource-name> with the name of your Web PubSub instance in the following command.
+Each Web PubSub resource must have a unique name. Replace <your-unique-resource-name> with the name of your Web PubSub instance in the following command.
 
 ```azurecli
-az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
+az webpubsub create --resource-group myResourceGroup --name <your-unique-resource-name> --location EastUS --sku Free_F1
 ```
 
 The output of this command shows properties of the newly created resource. Take note of the two properties listed below:
 
-* **Resource Name**: The name you provided to the `--name` parameter above.
+* **name**: The Web PubSub name you provided in the `--name` parameter above.
 * **hostName**: In the example, the host name is `<your-unique-resource-name>.webpubsub.azure.com/`.
 
 At this point, your Azure account is the only one authorized to perform any operations on this new resource.
@@ -97,7 +95,7 @@ Clients connect to the Azure Web PubSub service through the standard WebSocket p
 
 1. First, create a project directory named `subscriber` for this project and install required dependencies:
 
-    * The package [Websocket.Client](https://github.com/Marfusios/websocket-client) is a third-party package supporting WebSocket connection. You can use any API/library that supports WebSocket to do so.
+    * The package [Websocket.Client](https://github.com/Marfusios/websocket-client) is a third-party package supporting WebSocket connections. You can use any API/library that supports WebSocket.
     * The SDK package `Azure.Messaging.WebPubSub` helps to generate the JWT token. 
 
     ```console