Article review

Author: maud-lv

articles/managed-grafana/how-to-transition-domain.md

@@ -9,13 +9,23 @@ ms.date: 09/27/2022
 --- 
 
 # Transition to using the grafana.azure.com domain
-If you have an Azure Managed Grafana workspace that was created on or before 17 April 2022, it is accessible through two URL’s - one ending in azgrafana.io, and one ending in grafana.azure.com. Both links are identical and point to the same workspace. To avoid losing access to your Grafana workspace, you’ll need to verify that you can access your workspace through the grafana.azure.com endpoint, and that any links you may have that point to your workspace are using this endpoint as well. 
+
+If you have an Azure Managed Grafana instance that was created on or before April 17 2022, your workspace is accessible through two URLs: one ending in azgrafana.io and one ending in grafana.azure.com. Both links point to the same workspace.
+
+URLs ending in azgrafana.io will be deprecated in favor of the URL ending in grafana.azure.com. To avoid losing access to your Grafana workspace, you’ll need to verify that you can access your workspace through the grafana.azure.com endpoint, and that any links you may have that point to your workspace are using this endpoint as well.
 
 Azure Managed Grafana workspaces created on or after 18 April 2022 only have a grafana.azure.com URL, so no action is needed to transition those workspaces.
 
-## Steps to verify the transition
+## Verify the transition
+
+Verify that you are set to use the grafana.azure.com domain:
+
 1. In the Azure portal, go to your Azure Managed Grafana resource.
-     ![Overview header of a Grafana workspace](https://github.com/msoumar-ms/azure-docs/blob/main/articles/managed-grafana/media/grafana-endpoint/grafana-domain-view-endpoint.png)
-1. At the top of the Overview page, in Essentials, you should see the endpoint of your Grafana workspace. Verify that the URL ends in grafana.azure.com and that clicking the link takes you to the Grafana workspace itself.
-1. If you have any bookmarks or links in your own documentation to your Grafana workspace, be sure that they point to the same URL ending in grafana.azure.com as the endpoint in the Essentials tab.
-     ![Bookmark to a Grafana workspace](https://github.com/msoumar-ms/azure-docs/blob/main/articles/managed-grafana/media/grafana-endpoint/grafana-domain-bookmark-example.png)
+1. At the top of the **Overview** page, in **Essentials**, look for the endpoint of your Grafana workspace. Verify that the URL ends in grafana.azure.com and that clicking the link takes you to your Grafana endpoint.
+     :::image type="content" source="media/grafana-endpoint/grafana-domain-view-endpoint.png" alt-text="Screenshot of the Azure platform showing the Grafana endpoint URL.":::
+1. If you have any bookmarks or links in your own documentation to your Grafana workspace, make sure that they point to the URL ending in grafana.azure.com listed in the Azure portal.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Service reliability](./high-availability.md)

articles/managed-grafana/index.yml

@@ -39,8 +39,6 @@ landingContent:
             url: how-to-enable-zone-redundancy.md
           - text: Set up authentication and permissions
             url: how-to-authentication-permissions.md
-          - text: Transition to using the grafana.azure.com domain
-            url: how-to-transition-domain.md
   - title: Manage Azure Managed Grafana
     linkLists:
       - linkListType: how-to-guide

articles/managed-grafana/media/grafana-endpoint/grafana-domain-bookmark-example.png

@@ -43,6 +43,8 @@ items:
     href: how-to-enable-zone-redundancy.md
   - name: Use deterministic outbound IPs
     href: how-to-deterministic-ip.md
+  - name: Transition to grafana.azure.com domain
+    href: how-to-transition-domain.md
   - name: Troubleshoot common issues
     href: troubleshoot-managed-grafana.md
   - name: Known limitations