Refresh dashboard overview

Author: mgblythe

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

@@ -13,7 +13,7 @@ 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
 
 ---
@@ -35,7 +35,7 @@ In this example, we create a new, private dashboard and assign a name. Follow th
 
 1. Select **New dashboard**.
 
-    ![Screenshot of default dashboard](./media/azure-portal-dashboards/create-new-dashboard.png)
+    ![Screenshot of new dashboard](./media/azure-portal-dashboards/create-new-dashboard.png)
 
     This action opens the **Tile Gallery**, from which you'll select tiles, and an empty grid where you'll arrange the tiles.
 
@@ -45,13 +45,13 @@ In this example, we create a new, private dashboard and assign a name. Follow th
 
 1. Select **Done customizing** in the page header to exit edit mode.
 
-The dashboard view now shows your empty dashboard. Select the arrow next to the dashboard name to see dashboards available to you. The list might include dashboards that other users have created and shared.
+The dashboard view now shows your new dashboard. Select the arrow next to the dashboard name to see dashboards available to you. The list might include dashboards that other users have created and shared.
 
 ## Edit a dashboard
 
 Now, let's edit the dashboard to add, resize, and arrange tiles that represent your Azure resources.
 
-### Add tiles
+### Add tiles from the dashboard
 
 To add tiles to a dashboard, follow these steps:
 
@@ -63,14 +63,14 @@ To add tiles to a dashboard, follow these steps:
 
 1. Select **Add** to add the tile to the dashboard with a default size and location. Or, drag the tile to the grid and place it where you want.
 
-Many resource pages include a pushpin icon in the command bar. If you select the icon, a tile representing the source page is pinned to the dashboard that is currently active. This method is an alternative way to add tiles to your dashboard.
-
-![Screenshot of page command bar with pin icon](./media/azure-portal-dashboards/dashboard-pin-blade.png)
-
 > [!TIP]
 > If you work with more than one organization, add the **Organization identity** tile to your dashboard to clearly show which organization the resources belong to.
->
->
+
+### Add tiles from a resource page
+
+There is an alternative way to add tiles to your dashboard. Many resource pages include a pushpin icon in the command bar. If you select the icon, a tile representing the source page is pinned to the dashboard that is currently active. 
+
+![Screenshot of page command bar with pin icon](./media/azure-portal-dashboards/dashboard-pin-blade.png)
 
 ### Resize or rearrange tiles
 
@@ -88,14 +88,16 @@ To change the size of a tile or to rearrange the tiles on a dashboard, follow th
 
 Some tiles might require more configuration to show the information you want. For example, the **Metrics chart** tile has to be set up to display a metric from **Azure Monitor**. You can also customize tile data to override the dashboard's default time settings.
 
-Any tile that needs to be set up displays a **Configure tile** banner until you customize the tile. Select that banner, then do the required setup.
+Any tile that needs to be set up displays a **Configure tile** banner until you customize the tile. To customize the tile:
 
-![Screenshot of tile that requires configuration](./media/azure-portal-dashboards/dashboard-configure-tile.png)
+1. Select **Done customizing** in the page header to exit edit mode.
+
+1. Select the banner, then do the required setup.
+    ![Screenshot of tile that requires configuration](./media/azure-portal-dashboards/dashboard-configure-tile.png)
 
 > [!NOTE]
 > A markdown tile lets you display custom, static content on your dashboard. This could be basic instructions, an image, a set of hyperlinks, or even contact information. For more information about using a markdown tile, see [Use a markdown tile on Azure dashboards to show custom content](azure-portal-markdown-tile.md).
->
->
+
 ### Customize tile data
 
 Data on the dashboard automatically shows activity for the past 24 hours. To show a different time span for just this tile, follow these steps:
@@ -136,50 +138,27 @@ To use an existing dashboard as a template for a new dashboard, follow these ste
 
 ## Publish and share a dashboard
 
-When you create a dashboard, it's private by default, which means you're the only one who can see it. To make dashboards available to others, you can share them with other users. First, you have to publish the dashboard as an Azure resource. To publish and share a custom dashboard, follow these steps:
-
-1. Select ![share icon](./media/azure-portal-dashboards/dashboard-share-icon.png) **Share** from the page header. **Sharing + access control** opens.
-
-1. Verify that the correct dashboard name is shown.
-
-1. Select a **Subscription name**. Users with access to the subscription can use the shared dashboard. Access to the resources represented by the individual tiles is determined by Azure role-based access control.
-
-1. Select the checkbox to publish this dashboard to the 'dashboards' resource group for the selected subscription. Or, clear the checkbox and choose to publish to an existing resource group instead.
-
-1. Choose a location for the dashboard resource. We recommend you locate the dashboard with other resources. If you choose from existing resource groups, the dashboard is automatically located with that resource group.
-
-1. Select **Publish**.
-
-    ![Screenshot of dashboard publishing dialog](./media/azure-portal-dashboards/dashboard-publish.png)
-
-### Set access control on a shared dashboard
-
-After the dashboard is published, manage who has access to the dashboard by following these steps:
-
-1. In the **Sharing + access control** pane, select **Manage users**.
-
-    ![Screenshot of dashboard sharing + access control dialog](./media/azure-portal-dashboards/dashboard-share-access-control.png)
-
-1. The **Access Control** page opens. You can review the level of access for someone or add a new role assignment. When you add a role assignment here, you're granting permissions to the dashboard.
-
-> [!NOTE]
-> Tiles are representative views of resources in your organization. Access to resources is managed through role-based access control assignment and permissions are inherited from the subscription down to the resource. Giving access to a dashboard doesn't automatically assign permissions to the resources shown on the dashboard. For more information about permissions to shared dashboards and role-based access control for resources, see [Share Azure dashboards by using Role-Based Access Control](azure-portal-dashboard-share-access.md).
+When you create a dashboard, it's private by default, which means you're the only one who can see it. To make dashboards available to others, you can publish and share them. For more information, see [Share Azure dashboards by using Role-Based Access Control](azure-portal-dashboard-share-access.md).
 
 ### Open a shared dashboard
 
 To find and open a shared dashboard, follow these steps:
 
 1. Select the arrow next to the dashboard name.
 
-1. Select from the displayed list of dashboards or **Browse all dashboards** if the dashboard you want to open isn't listed.
+1. Select from the displayed list of dashboards. If the dashboard you want to open isn't listed:
+
+    1. select **Browse all dashboards**.
+
+        ![Screenshot of dashboard selection menu](./media/azure-portal-dashboards/dashboard-browse.png)
 
-    ![Screenshot of dashboard selection menu](./media/azure-portal-dashboards/dashboard-browse.png)
+    1. In the **Type** field, select **Shared dashboards**.
 
-1. In the **Type** field, select **Shared dashboards**.
+        ![Screenshot of all dashboards selection menu](./media/azure-portal-dashboards/dashboard-browse-all.png)
 
-1. Select one or more subscriptions. You can also enter text to filter dashboards by name.
+    1. Select one or more subscriptions. You can also enter text to filter dashboards by name.
 
-1. Select a dashboard from the list of shared dashboards.
+    1. Select a dashboard from the list of shared dashboards.
 
 ## Delete a dashboard