Refresh create dashboards programmatically

Author: mgblythe

articles/azure-portal/azure-portal-dashboards-create-programmatically.md

@@ -12,23 +12,23 @@ ms.devlang: NA
 ms.topic: conceptual
 ms.tgt_pltfrm: NA
 ms.workload: na
-ms.date: 01/29/2020
+ms.date: 03/23/2020
 ms.author: mblythe
 
 ---
 # Programmatically create Azure Dashboards
 
-This document walks through the process of programmatically creating and publishing Azure dashboards. The dashboard shown below is referenced throughout the document.
+This article walks you through the process of programmatically creating and publishing Azure dashboards. The dashboard shown below is referenced throughout the document.
 
 ![sample dashboard](./media/azure-portal-dashboards-create-programmatically/sample-dashboard.png)
 
 ## Overview
 
-Shared dashboards in the [Azure portal](https://portal.azure.com) are [resources](../azure-resource-manager/management/overview.md) just like virtual machines and storage accounts. You can manage resources programmatically by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), and [Azure PowerShell commands](/powershell/azure/get-started-azureps).  
+Shared dashboards in the [Azure portal](https://portal.azure.com) are [resources](../azure-resource-manager/management/overview.md) just like virtual machines and storage accounts. You can manage resources programmatically by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), and [Azure PowerShell commands](/powershell/azure/get-started-azureps).
 
 Many features build on these APIs to make resource management easier. Each of these APIs and tools offers ways to create, list, retrieve, modify, and delete resources. Since dashboards are resources, you can pick your favorite API or tool to use.
 
-Whichever tools you use, you need to construct a JSON representation of your dashboard object. This object contains information about the tiles on the dashboard. It includes sizes, positions, resources they're bound to, and any user customizations.
+Whichever tools you use, to create a dashboard programmatically, you construct a JSON representation of your dashboard object. This object contains information about the tiles on the dashboard. It includes sizes, positions, resources they're bound to, and any user customizations.
 
 The most practical way to build up this JSON document is to use the Azure portal. You can interactively add and position your tiles. Then export the JSON and create a template from the result for later use in scripts, programs, and deployment tools.
 
@@ -48,7 +48,7 @@ Others have fixed sizes to choose from in their context menu.
 
 ## Share the dashboard
 
-After you configure the dashboard, the next steps are to publish the dashboard using the **Share** command and then use the Resource Explorer to fetch the JSON.
+After you configure the dashboard, the next step is to publish the dashboard using the **Share** command.
 
 ![sharing a dashboard](./media/azure-portal-dashboards-create-programmatically/share-command.png)
 
@@ -58,13 +58,9 @@ Selecting **Share** prompts you to choose which subscription and resource group
 
 ## Fetch the JSON representation of the dashboard
 
-Publishing only takes a few seconds.  When it's done, the next step is to go to the [Resource Explorer](https://portal.azure.com/#blade/HubsExtension/ArmExplorerBlade) to fetch the JSON.
+Publishing only takes a few seconds. When it's done, the next step is to fetch the JSON using the **Download** command.
 
-![browse Resource Explorer](./media/azure-portal-dashboards-create-programmatically/search-resource-explorer.png)
-
-From the Resource Explorer, navigate to the subscription and resource group that you chose. Next, select the newly published dashboard resource to reveal the JSON.
-
-![view JSON in Resource Explorer](./media/azure-portal-dashboards-create-programmatically/resource-explorer-json-detail.png)
+![download JSON representation](./media/azure-portal-dashboards-create-programmatically/download-command.png)
 
 ## Create a template from the JSON
 
@@ -123,21 +119,18 @@ Declare required template metadata and the parameters at the top of the JSON tem
 
     ... rest of template omitted ...
 ```
-
-You can see the full, working template at the end of this document.
-
 Once you've configured your template, deploy it using any of the following methods:
 
 * [REST APIs](/rest/api/resources/deployments)
 * [PowerShell](../azure-resource-manager/resource-group-template-deploy.md)
 * [Azure CLI](/cli/azure/group/deployment#az-group-deployment-create)
 * [The Azure portal template deployment page](https://portal.azure.com/#create/Microsoft.Template)
 
-Here are two versions of our example dashboard JSON. The first is the version that we exported from the portal that was already bound to a resource. The second is the template version that can be programmatically bound to any virtual machine and deployed using Azure Resource Manager.
+Next you'll see two versions of our example dashboard JSON. The first is the version that we exported from the portal that was already bound to a resource. The second is the template version that can be programmatically bound to any virtual machine and deployed using Azure Resource Manager.
 
-## JSON representation of our example dashboard before templating
+### JSON representation of our example dashboard before templating
 
-This example shows what you can expect to see if you followed along with this article. The instructions exported the JSON representation of a dashboard that is already deployed. The hard-coded resource identifiers that show that this dashboard is pointing at a specific Azure virtual machine.
+This example shows what you can expect to see if you followed along with this article. The instructions exported the JSON representation of a dashboard that is already deployed. The hard-coded resource identifiers show that this dashboard is pointing at a specific Azure virtual machine.
 
 ```json
 
@@ -659,6 +652,6 @@ This example deploys a dashboard by itself, but the template language lets you d
         }
     ]
 }
-
-
 ```
+
+Now that you've seen an example of using a parameterized template to deploy a dashboard, you can try deploying the template by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), or [Azure PowerShell commands](/powershell/azure/get-started-azureps).