edit arg quickstarts

Author: davidsmatlak

articles/governance/resource-graph/first-query-azurecli.md

@@ -1,7 +1,7 @@
 ---
 title: "Quickstart: Run Resource Graph query using Azure CLI"
 description: In this quickstart, you run a Resource Graph query using Azure CLI and the resource-graph extension.
-ms.date: 06/26/2024
+ms.date: 06/27/2024
 ms.topic: quickstart
 ms.custom: devx-track-azurecli
 ---
@@ -16,18 +16,6 @@ This quickstart describes how to run an Azure Resource Graph query using the Azu
 - [Azure CLI](/cli/azure/install-azure-cli) must be version 2.22.0 or higher for the Resource Graph extension.
 - A Bash shell environment where you can run Azure CLI commands. For example, Git Bash in a [Visual Studio Code](https://code.visualstudio.com/) terminal session.
 
-## Connect to Azure
-
-From a Visual Studio Code terminal session, connect to Azure. If you have more than one subscription, run the commands to set context to your subscription. Replace `<subscriptionID>` with your Azure subscription ID.
-
-```azurecli
-az login
-
-# Run these commands if you have multiple subscriptions
-az account list --output table
-az account set --subscription <subscriptionID>
-```
-
 ## Install the extension
 
 To enable Azure CLI to query resources using Azure Resource Graph, the Resource Graph extension must be installed. The first time you run a query with `az graph` a prompt is displayed to install the extension. Otherwise, use the following steps to do a manual installation.
@@ -58,6 +46,18 @@ To enable Azure CLI to query resources using Azure Resource Graph, the Resource
 
    For more information about Azure CLI extensions, go to [Use and manage extensions with the Azure CLI](/cli/azure/azure-cli-extensions-overview).
 
+## Connect to Azure
+
+From a Visual Studio Code terminal session, connect to Azure. If you have more than one subscription, run the commands to set context to your subscription. Replace `<subscriptionID>` with your Azure subscription ID.
+
+```azurecli
+az login
+
+# Run these commands if you have multiple subscriptions
+az account list --output table
+az account set --subscription <subscriptionID>
+```
+
 ## Run a query
 
 After the Azure CLI extension is added to your environment, you can run a tenant-based query. The query in this example returns five Azure resources with the `name` and `type` of each resource. To query by [management group](../management-groups/overview.md) or subscription, use the `--management-groups` or `--subscriptions` arguments.
@@ -102,7 +102,7 @@ az logout
 
 ## Next steps
 
-In this quickstart, you ran Azure Resource Graph queries using the extension for Azure CLI. To learn more, go to the query language details article.
+In this quickstart, you ran Azure Resource Graph queries using the extension for Azure CLI. To learn more about the Resource Graph language, continue to the query language details page.
 
 > [!div class="nextstepaction"]
 > [Understanding the Azure Resource Graph query language](./concepts/query-language.md)

articles/governance/resource-graph/shared-query-azure-cli.md

@@ -1,7 +1,7 @@
 ---
 title: "Quickstart: Create Resource Graph shared query using Azure CLI"
 description: In this quickstart, you create an Azure Resource Graph shared query using Azure CLI and the resource-graph extension.
-ms.date: 06/26/2024
+ms.date: 06/27/2024
 ms.topic: quickstart
 ms.custom: devx-track-azurecli
 ---
@@ -18,18 +18,6 @@ A shared query can be run from Azure CLI with the _experimental_ feature's comma
 - [Azure CLI](/cli/azure/install-azure-cli) must be version 2.22.0 or higher for the Resource Graph extension.
 - A Bash shell environment where you can run Azure CLI commands. For example, Git Bash in a [Visual Studio Code](https://code.visualstudio.com/) terminal session.
 
-## Connect to Azure
-
-From a Visual Studio Code terminal session, connect to Azure. If you have more than one subscription, run the commands to set context to your subscription. Replace `<subscriptionID>` with your Azure subscription ID.
-
-```azurecli
-az login
-
-# Run these commands if you have multiple subscriptions
-az account list --output table
-az account set --subscription <subscriptionID>
-```
-
 ## Install the extension
 
 To enable Azure CLI to query resources using Azure Resource Graph, the Resource Graph extension must be installed. The first time you run a query with `az graph` a prompt is displayed to install the extension. Otherwise, use the following steps to do a manual installation.
@@ -60,6 +48,18 @@ To enable Azure CLI to query resources using Azure Resource Graph, the Resource
 
   For more information about Azure CLI extensions, go to [Use and manage extensions with the Azure CLI](/cli/azure/azure-cli-extensions-overview).
 
+## Connect to Azure
+
+From a Visual Studio Code terminal session, connect to Azure. If you have more than one subscription, run the commands to set context to your subscription. Replace `<subscriptionID>` with your Azure subscription ID.
+
+```azurecli
+az login
+
+# Run these commands if you have multiple subscriptions
+az account list --output table
+az account set --subscription <subscriptionID>
+```
+
 ## Create a shared query
 
 Create a resource group and a shared that summarizes the count of all resources grouped by location.
@@ -126,16 +126,24 @@ You can verify the shared query works using Azure Resource Graph Explorer. To ch
 1. Change **Type** to _Shared queries_.
 1. Select the query _Count VMs by OS_.
 1. Select **Run query** and the view output in the **Results** tab.
+1. Select **Charts** and then select **Map** to view the location map.
 
 You can also run the query from your resource group. 
 
 1. In Azure, go to the resource group, _demoSharedQuery_.
 1. From the **Overview** tab, select the query _Count VMs by OS_.
 1. Select the **Results** tab.
+1. Select **Charts** and then select **Map** to view the location map.
 
 ## Clean up resources
 
-To remove the resource group and shared query:
+To remove the shared query:
+
+```azurecli
+az graph shared-query delete --name "Summarize resources by location" --resource-group demoSharedQuery
+```
+
+When a resource group is deleted, the resource group and all its resources are deleted. To remove the resource group:
 
 ```azurecli
 az group delete --name demoSharedQuery
@@ -155,9 +163,7 @@ az logout
 
 ## Next steps
 
-In this quickstart, you added the Resource Graph extension to your Azure CLI environment and
-created a shared query. To learn more about the Resource Graph language, continue to the query
-language details page.
+In this quickstart, you added the Resource Graph extension to your Azure CLI environment and created a shared query. To learn more about the Resource Graph language, continue to the query language details page.
 
 > [!div class="nextstepaction"]
 > [Understanding the Azure Resource Graph query language](./concepts/query-language.md)

articles/governance/resource-graph/shared-query-bicep.md

@@ -67,15 +67,15 @@ Create a resource group and deploy the Bicep file with Azure CLI or Azure PowerS
 # [Azure CLI](#tab/azure-cli)
 
 ```azurecli
-az group create --name exampleRG --location eastus
-az deployment group create --resource-group exampleRG --template-file main.bicep
+az group create --name demoSharedQuery --location eastus
+az deployment group create --resource-group demoSharedQuery --template-file main.bicep
 ```
 
 # [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-New-AzResourceGroup -Name exampleRG -Location eastus
-New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile main.bicep
+New-AzResourceGroup -Name demoSharedQuery -Location eastus
+New-AzResourceGroupDeployment -ResourceGroupName demoSharedQuery -TemplateFile main.bicep
 ```
 
 ---
@@ -89,13 +89,13 @@ Use Azure CLI or Azure PowerShell to list the deployed resources in the resource
 # [Azure CLI](#tab/azure-cli)
 
 ```azurecli
-az resource list --resource-group exampleRG
+az resource list --resource-group demoSharedQuery
 ```
 
 # [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-Get-AzResource -ResourceGroupName exampleRG 
+Get-AzResource -ResourceGroupName demoSharedQuery 
 ```
 
 ---
@@ -116,18 +116,18 @@ You can verify the shared query works using Azure Resource Graph Explorer. To ch
 
 You can also run the query from your resource group. 
 
-1. In Azure, go to the resource group, _exampleRG_.
+1. In Azure, go to the resource group, _demoSharedQuery_.
 1. From the **Overview** tab, select the query _Count VMs by OS_.
 1. Select the **Results** tab.
 
 ## Clean up resources
 
-When you no longer need the resource that you created, delete the resource group using Azure CLI or Azure PowerShell. And if you signed into Azure portal to run the query, be sure to sign out.
+When you no longer need the resource that you created, delete the resource group using Azure CLI or Azure PowerShell. When a resource group is deleted, the resource group and all its resources are deleted. And if you signed into Azure portal to run the query, be sure to sign out.
 
 # [Azure CLI](#tab/azure-cli)
 
 ```azurecli
-az group delete --name exampleRG
+az group delete --name demoSharedQuery
 ```
 
 To sign out of your Azure CLI session:
@@ -139,7 +139,7 @@ az logout
 # [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-Remove-AzResourceGroup -Name exampleRG
+Remove-AzResourceGroup -Name demoSharedQuery
 ```
 
 To sign out of your Azure PowerShell session:
@@ -152,9 +152,7 @@ Disconnect-AzAccount
 
 ## Next steps
 
-In this quickstart, you created a Resource Graph shared query using Bicep.
-
-To learn more about shared queries, continue to the tutorial for:
+In this quickstart, you created a Resource Graph shared query using Bicep. To learn more about the Resource Graph language, continue to the query language details page.
 
 > [!div class="nextstepaction"]
-> [Tutorial: Create and share an Azure Resource Graph query in the Azure portal](./tutorials/create-share-query.md)
+> [Understanding the Azure Resource Graph query language](./concepts/query-language.md)

articles/governance/resource-graph/shared-query-template.md

@@ -1,5 +1,5 @@
 ---
-title: 'Quickstart: Create Resource Graph shared query using ARM template'
+title: "Quickstart: Create Resource Graph shared query using ARM template"
 description: In this quickstart, you use an Azure Resource Manager template (ARM template) to create a Resource Graph shared query that counts virtual machines by OS.
 ms.date: 06/26/2024
 ms.topic: quickstart
@@ -91,9 +91,7 @@ To remove the shared query created, follow these steps:
 
 ## Next steps
 
-In this quickstart, you created a Resource Graph shared query.
-
-To learn more about shared queries, continue to the tutorial for:
+In this quickstart, you created a Resource Graph shared query. To learn more about the Resource Graph language, continue to the query language details page.
 
 > [!div class="nextstepaction"]
-> [Manage queries in Azure portal](./tutorials/create-share-query.md)
+> [Understanding the Azure Resource Graph query language](./concepts/query-language.md)