editorial review

Author: kgremban

articles/azure-arc/site-manager/how-to-crud-site.md

@@ -43,10 +43,11 @@ Create a site to manage geographically related resources.
 
    | Parameter | Description |
    |--|--|
-   | **Site scope** | **Subscription** or **Resource group**. The scope can only be defined at the time of creating a site and can't be modified later. All the resources in the scope can be viewed and managed from site manager. |
    | **Site name** | Custom name for site. |
    | **Display name** | Custom display name for site. |
+   | **Site scope** | Either **Subscription** or **Resource group**. The scope can only be defined at the time of creating a site and can't be modified later. All the resources in the scope can be viewed and managed from site manager. |
    | **Subscription** | Subscription for the site to be created under. |
+   | **Resource group** | The resource group for the site, if the scope was set to resource group. |
    | **Address** | Physical address for a site. |
 
 1. Once these details are provided, select **Review + create**.

articles/azure-arc/site-manager/how-to-view-alerts.md

@@ -43,17 +43,17 @@ View alert status for an Arc site from the main page of Azure Arc site manager (
 
    :::image type="content" source="./media/how-to-view-alerts/overview-sites-page.png" alt-text="Screenshot that shows selecting the overview page from site manager.":::
 
-1. In the **Overview** page, you can view the summarized alert statuses of all sites. This site-level alert status is an aggregation of all the alert statuses of the resources in that site. In the example below, sites are shown with different statuses.
+1. On the **Overview** page, you can view the summarized alert statuses of all sites. This site-level alert status is an aggregation of all the alert statuses of the resources in that site. In the following example, sites are shown with different statuses.
 
-   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts.png" alt-text="Screenshot that shows viewing the alert status on the site manager overview page.":::
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts.png" alt-text="Screenshot that shows viewing the alert status on the site manager overview page." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts.png":::
 
 1. To understand which site has which status, select either the **Sites** tab or the blue status text.
 
-   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details.png" alt-text="Screenshot of site manager overview page directing to the sites page to view more details.":::
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details.png" alt-text="Screenshot of site manager overview page directing to the sites page to view more details." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details.png":::
 
 1. The **sites** page shows the top-level status for each site, which reflects the most significant status for the site.
 
-   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-site-page.png" alt-text="Screenshot that shows the top level alerts status for each site.":::
+   :::image type="content" source="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-site-page.png" alt-text="Screenshot that shows the top level alerts status for each site." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-site-page.png":::
 
 1. If there's an alert, select the status text to open details for a given site. You can also select the name of the site to open its details.
 

articles/azure-arc/site-manager/how-to-view-connectivity-status.md

@@ -41,19 +41,19 @@ You can view connectivity status for an Arc site as a whole from the main page o
 
    :::image type="content" source="./media/how-to-view-connectivity-status/overview-sites-page.png" alt-text="Screenshot that shows selecting the Overview page in site manager.":::
 
-1. On the **Overview** page, you can see a summary of the connectivity statuses of all your sites. The connectivity status of a given site is an aggregation of the connectivity status of its resources. In the example below, sites are shown with different statuses.
+1. On the **Overview** page, you can see a summary of the connectivity statuses of all your sites. The connectivity status of a given site is an aggregation of the connectivity status of its resources. In the following example, sites are shown with different statuses.
 
-   :::image type="content" source="./media/how-to-view-connectivity-status/site-connection-overview.png" alt-text="Screenshot that shows the connectivity view in the sites overview page.":::
+   :::image type="content" source="./media/how-to-view-connectivity-status/site-connection-overview.png" alt-text="Screenshot that shows the connectivity view in the sites overview page." lightbox="./media/how-to-view-connectivity-status/site-connection-overview.png":::
 
 1. To understand which site has which status, select either the **sites** tab or the blue colored status text to be directed to the **sites** page.
 
-   :::image type="content" source="./media/how-to-view-connectivity-status/click-connectivity-status-site-details.png" alt-text="Screenshot that shows selecting the Sites tab to get more detail about connectivity status.":::
+   :::image type="content" source="./media/how-to-view-connectivity-status/click-connectivity-status-site-details.png" alt-text="Screenshot that shows selecting the Sites tab to get more detail about connectivity status." lightbox="./media/how-to-view-connectivity-status/click-connectivity-status-site-details.png":::
 
 1. On the **Sites** page, you can view the top-level status for each site. This site-level status reflects the most significant resource-level status for the site.
 
 1. Select the **Needs attention** link to view the resource details.
 
-   :::image type="content" source="./media/how-to-view-connectivity-status/site-connectivity-status-from-sites-page.png" alt-text="Screenshot that shows selecting the connectivity status for a site to see the resource details.":::
+   :::image type="content" source="./media/how-to-view-connectivity-status/site-connectivity-status-from-sites-page.png" alt-text="Screenshot that shows selecting the connectivity status for a site to see the resource details." lightbox="./media/how-to-view-connectivity-status/site-connectivity-status-from-sites-page.png":::
 
 1. On the site's resource page, you can view the connectivity status for each resource within the site, including the resource responsible for the top-level most significant status.
 

articles/azure-arc/site-manager/how-to-view-update-status.md

@@ -45,20 +45,20 @@ You can view update status for an Arc site as a whole from the main page of Azur
 
    :::image type="content" source="./media/how-to-view-update-status/overview-sites-page.png" alt-text="Screenshot that shows selecting the Overview page in site manager.":::
 
-1. In the **Overview** page, you can view the summarized update statuses of your sites. This site-level status is aggregated from the statuses of its managed resources. In the example below, sites are shown with different statuses.
+1. On the **Overview** page, you can view the summarized update statuses of your sites. This site-level status is aggregated from the statuses of its managed resources. In the following example, sites are shown with different statuses.
 
-   :::image type="content" source="./media/how-to-view-update-status/site-manager-update-status-overview-page.png" alt-text="Screenshot that shows the update status summary on the view page.":::
+   :::image type="content" source="./media/how-to-view-update-status/site-manager-update-status-overview-page.png" alt-text="Screenshot that shows the update status summary on the view page." lightbox="./media/how-to-view-update-status/site-manager-update-status-overview-page.png":::
 
 1. To understand which site has which status, select either the **sites** tab or the blue colored status text to be directed to the **sites** page.
 
-   :::image type="content" source="./media/how-to-view-update-status/click-update-status-site-details.png" alt-text="Screenshot that shows selecting the Sites tab to get more detail about update status.":::
+   :::image type="content" source="./media/how-to-view-update-status/click-update-status-site-details.png" alt-text="Screenshot that shows selecting the Sites tab to get more detail about update status." lightbox="./media/how-to-view-update-status/click-update-status-site-details.png":::
 
 1. On the **Sites** page, you can view the top-level status for each site. This site-level status reflects the most significant resource-level status for the site.
 
 1. Select the **Needs attention** link to view the resource details.
 
-   :::image type="content" source="./media/how-to-view-update-status/site-update-status-from-sites-page.png" alt-text="Screenshot that shows selecting the update status for a site to see the resource details.":::
+   :::image type="content" source="./media/how-to-view-update-status/site-update-status-from-sites-page.png" alt-text="Screenshot that shows selecting the update status for a site to see the resource details." lightbox="./media/how-to-view-update-status/site-update-status-from-sites-page.png" :::
 
 1. On the site's resource page, you can view the update status for each resource within the site, including the resource responsible for the top-level most significant status.
 
-   :::image type="content" source="./media/how-to-view-update-status/los-angeles-resource-status-updates.png" alt-text="Screenshot that shows using the site details page to identify resources with pending or in progress updates.":::
+   :::image type="content" source="./media/how-to-view-update-status/los-angeles-resource-status-updates.png" alt-text="Screenshot that shows using the site details page to identify resources with pending or in progress updates." lightbox="./media/how-to-view-update-status/los-angeles-resource-status-updates.png" :::

articles/azure-arc/site-manager/index.yml

@@ -46,15 +46,4 @@ landingContent:
             url: how-to-view-alerts.md
           - text: Configure Azure Monitor alerts
             url: how-to-configure-monitor-site.md
-          - text: Known issues
-            url: known-issues.md
-          - text: Troubleshoot
-            url: troubleshooting.md
-  - title: Explore more
-    linkLists:
-      - linkListType: reference
-        links:
-          - text: Learn more about Azure Arc
-            url: ../overview.md
-          - text: Learn more about Azure Monitor
-            url: ../../azure-monitor/overview.md
+

articles/azure-arc/site-manager/overview.md

@@ -13,12 +13,24 @@ ms.custom: references_regions
 
 # What is Azure Arc site manager (preview)?
 
-Azure Arc site manager allows you to manage and monitor your on-premises environments within Azure Arc. Arc sites are scoped to an Azure resource group or subscription and enable you to track connectivity, alerts, and updates across your environment. The experience is tailored for on-premises scenarios where infrastructure is often managed within a common physical boundary, such as a store, restaurant, or factory.
+Azure Arc site manager allows you to manage and monitor your on-premises environments as Azure Arc *sites*. Arc sites are scoped to an Azure resource group or subscription and enable you to track connectivity, alerts, and updates across your environment. The experience is tailored for on-premises scenarios where infrastructure is often managed within a common physical boundary, such as a store, restaurant, or factory.
 
 > [!IMPORTANT]
 > Azure Arc site manager is currently in PREVIEW.
 > See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
 
+## Set an Arc site scope
+
+When you create a site, you scope it to either a resource group or a subscription. The site automatically pulls in any supported resources within its scope.
+
+Arc sites currently have a 1:1 relationship with resource groups and subscriptions. Any given Arc site can only be associated to one resource group or subscription, and vice versa. 
+
+You can create a hierarchy of sites by creating one site for a subscription and more sites for the resource groups within the subscription. The following screenshot shows an example of a hierarchy, with sites for **Los Angeles**, **San Francisco**, and **New York** nested within the site **United States**.
+
+:::image type="content" source="./media/overview/site-nested-world.png" alt-text="Screenshot that shows Site manager with a nested site." lightbox="./media/overview/site-nested-world.png":::
+
+With site manager, customers who manage on-premises infrastructure can view resources based on their physical site or location. Sites don't logically have to be associated with a physical grouping. You can use sites in whatever way supports your scenario. For example, you could create a site that groups resources by function or type rather than location.
+
 ## Supported resource types
 
 Currently, site manager supports the following Azure resources with the following capabilities:
@@ -34,23 +46,17 @@ Currently, site manager supports the following Azure resources with the followin
 
 Site manager only provides status aggregation for the supported resource types. Site manager doesn't manage resources of other types that exist in the resource group or subscription, but those resources continue to function normally otherwise.
 
+## Regions
+
 Site manager supports resources that exist in [supported regions](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc&regions=all), with a few exceptions. For the following regions, connectivity and update status aren't supported for Arc-enabled machines or Arc-enabled Kubernetes clusters:
 
 * Brazil South
 * UAE North
 * South Africa North
 
-## Set an Arc site scope
-
-Arc sites currently have a 1:1 relationship with resource groups and subscriptions. Any given Arc site can only be associated to one resource group or subscription, and vice versa. You can create a hierarchy of sites by creating one site for a subscription and more sites for the resource groups within the subscription.
-
-An example of a hierarchy is shown with **London** and **California** sites within the site **World**.
-
-:::image type="content" source="./media/overview/site-nested-world.png" alt-text="Screenshot that shows Site manager with a nested site.":::
-
-## Azure Arc site manager pricing
+## Pricing
 
-Site manager is free to use. For the Azure services that integrate with sites and site manager, including Azure Monitor alerts, refer to the individual service's pricing page.
+Site manager is free to use, but integrates with other Azure services that have their own pricing models. For your managed resources and monitoring configuration, including Azure Monitor alerts, refer to the individual service's pricing page.
 
 ## Next steps