Merge pull request #272633 from kgremban/site-manager-bugbash-2

Feedback from docs bugbash

Author: AnnaMHuff

articles/azure-arc/index.yml

@@ -170,6 +170,6 @@ additionalContent:
           summary: Azure IoT Operations is a unified data plane for the edge that helps organizations deploy the industrial metaverse.
           url: /azure/iot-operations/
         # Card
-        - title: Azure Arc site manager
+        - title: Azure Arc site manager (preview)
           summary: Use Arc sites to represent your on-premises environments and see centralized monitoring information across your edge infrastructure.
           url: /azure/azure-arc/site-manager/

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

@@ -19,26 +19,16 @@ The following are frequently asked questions and answers for Azure Arc site mana
 
 **Question:** I have resources in the resource group, which aren't yet supported by site manager. Do I need to move them?
 
-**Answer:** Site manager provides health status aggregation for only the supported resource types. Resources of other types won't be managed via site manager. They continue to function normally as they would without otherwise.
-
-**Question:** Can I update a site after it has been created?
-
-**Answer:** After creation, site properties and details can't be updated aside from site name and site address. The best way to update the site properties is to delete the site and create a new site.
+**Answer:** Site manager provides status aggregation for only the supported resource types. Resources of other types won't be managed via site manager. They continue to function normally as they would without otherwise.
 
 **Question:** Does site manager have a subscription or fee for usage?
 
-**Answer:** Site manager doesn't have any fee, so feel free to create and use as many sites as desired. However, the Azure services that integrated with sites and site manager might have a fee. Additionally, alerts used with site manager via monitor might have fees as well.
+**Answer:** Site manager is free. However, the Azure services that integrated with sites and site manager might have a fee. Additionally, alerts used with site manager via monitor might have fees as well.
 
 **Question:** What regions are currently supported via site manager? What regions of these supported regions aren't fully supported?
 
-**Answer:** Regions supported can be found [here](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/?products=azure-arc&regions=all). Currently, all supported regions have full support for resources except for the following:
-
-| Region | Support limitation |
-|--|--|
-| Brazil South | Connectivity and updates status aren't supported for Arc-enabled machines or Arc-enabled Kubernetes clusters |
-| UAE North | Connectivity and updates status aren't supported for Arc-enabled machines or Arc-enabled Kubernetes clusters |
-| South Africa North | Connectivity and updates status aren't supported for Arc-enabled machines or Arc-enabled Kubernetes clusters |
-
-**Question:** Does an Arc site have to represent a physical site or location?
+**Answer:** 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:
 
-**Answer:** Site manager is tailored for customers who manage on-premises infrastructure. Arc sites can also be created to represent more than just a physical location as well.
+* Brazil South
+* UAE North
+* South Africa North

articles/azure-arc/site-manager/how-to-configure-monitor-site.md

@@ -1,31 +1,35 @@
 ---
 title: "How to configure Azure Monitor alerts for a site"
-description: "How to configure monitor for a site."
+description: "Describes how to create and configure alerts using Azure Monitor to manage resources in an Azure Arc site."
 author: kgremban
 ms.author: kgremban
 ms.service: azure-arc
 #ms.subservice: site-manager
 ms.topic: how-to #Don't change
-ms.date: 03/24/2024
+ms.date: 04/18/2024
 
 #customer intent: As a site admin, I want to know where to create a alert in Azure for my site so that I can deploy monitoring for resources in my site.
 
 ---
 
 # Monitor sites in Azure Arc
 
-Sites within Azure Arc aren't able to have monitoring set up on the site overall. Instead, customers can set up alerts and monitoring for supported resources within a site. Once alerts are set up and triggered depending on the alert criteria, site manager makes the resource alert status visible within the Azure Arc site manager (preview) pages.
+Azure Arc sites provide a centralized view to monitor  groups of resources, but don't provide monitoring capabilities for the site overall. Instead, customers can set up alerts and monitoring for supported resources within a site. Once alerts are set up and triggered depending on the alert criteria, Azure Arc site manager (preview) makes the resource alert status visible within the site pages.
+
+If you aren't familiar with Azure Monitor, learn more about how to [monitor Azure resources with Azure Monitor](../../azure-monitor/essentials/monitor-azure-resource.md).
 
 ## Prerequisites
 
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
 * Azure portal access
 * Internet connectivity
-* Subscription
-* Resource group or subscription with at-least one resource for sites that supports alerts
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+
+## Configure alerts for sites in Azure Arc
 
-## Configure monitoring and alerts for sites in Azure Arc
+This section provides basic steps for configuring alerts for sites in Azure Arc. For more detailed information about Azure Monitor, see [Create or edit an alert rule](../../azure-monitor/alerts/alerts-create-metric-alert-rule.md).
 
-To configure monitoring and alerts for sites in Azure Arc, follow the below steps.
+To configure alerts for sites in Azure Arc, follow the below steps.
 
 1. Navigate to Azure Monitor by searching for **monitor** within the Azure portal. Select **Monitor** as shown.
 

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

@@ -6,7 +6,7 @@ ms.author: kgremban
 ms.service: azure-arc
 #ms.subservice: site-manager
 ms.topic: how-to #Don't change
-ms.date: 03/24/2024
+ms.date: 04/18/2024
 
 #customer intent: As a site admin, I want to know how to create, delete, and modify sites so that I can manage my site.
 
@@ -18,10 +18,10 @@ This article guides you through how to create, modify, and delete a site using A
 
 ## Prerequisites
 
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
 * Azure portal access
 * Internet connectivity
-* Subscription
-* Resource group or subscription with at least one resource for a site
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
 
 ## Open Azure Arc site manager
 
@@ -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**.
@@ -75,22 +76,20 @@ Once you create a site, you can access it and its managed resources through site
 
    * View resources
    * Modify resources (modifications affect the resources elsewhere as well)
-   * View connectivity status (when supported by resources)
-   * View update status (when supported by resources)
-   * View alerts (when supported by resources)
-   * Add new resources (currently only resources supporting creation from the site view)
+   * View connectivity status
+   * View update status
+   * View alerts
+   * Add new resources
 
-Additionally, currently only some aspects of a site can be modified. These are as follows:
+Currently, only some aspects of a site can be modified. These are as follows:
 
 | Site Attribute | Modification that can be done |
 |--|--|
-| Site name | Site name can be modified to a new unique name |
-| Address | Address can be modified to a pre-existing or new address |
+| Display name | Update the display name of a site to a new unique name. |
+| Address | Update the address of a site to an existing or new address. |
 
 ## Delete a site
 
-If you no longer want to manage a site, you can delete it from the site manager.
-
 Deleting a site doesn't affect the resources, resource group, or subscription in its scope. After a site is deleted, the resources of that site will still exist but can't be viewed or managed from site manager. You can create a new site for the resource group or the subscription after the original site is deleted.
 
 1. From the main **Site manager** page in **Azure Arc**, select **Sites** to view all existing sites.

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

@@ -6,32 +6,32 @@ ms.author: kgremban
 ms.service: azure-arc
 #ms.subservice: site-manager
 ms.topic: how-to #Don't change
-ms.date: 02/16/2024
+ms.date: 04/18/2024
 
 ---
 
-# How to view alert status for an Arc site
+# How to view alert status for an Azure Arc site
 
-This article details how to view the alert status for an Arc site. A site's alert status reflects the status of the underlying resources. From the site status view, you can find detailed status information for the supported resources as well.
+This article details how to view the alert status for an Azure Arc site. A site's alert status reflects the status of the underlying resources. From the site status view, you can find detailed status information for the supported resources as well.
 
 ## Prerequisites
 
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
 * Azure portal access
 * Internet connectivity
-* Subscription
-* Resource group or subscription with at least one resource for a site
-* A site created for the associated resource group or subscription
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+* A site created for the associated resource group or subscription. If you don't have one, see [Create and manage sites](./how-to-crud-site.md).
 
 ## Alert status colors and meanings
 
 In the Azure portal, status is indicated using color.
 
-* Red: **Critical**
-* Orange: **Error**
-* Yellow: **Warning**
+* Green: **Up to Date**
 * Blue: **Info**
 * Purple: **Verbose**
-* Green: **Up to Date**
+* Yellow: **Warning**
+* Orange: **Error**
+* Red: **Critical**
 
 ## View alert status
 
@@ -43,20 +43,20 @@ 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 important status for the site.
+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.
 
-1. On a site's resource page, you can view the alert status for each resource within the site, including the resource responsible for the top-level most important status.
+1. On a site's resource page, you can view the alert 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-alerts/site-manager-overview-alerts-details-status-los-angeles.png" alt-text="Screenshot that shows the site detail page with alert status for each resource." lightbox="./media/how-to-view-alerts/site-manager-overview-alerts-details-status-los-angeles.png":::

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

@@ -6,7 +6,7 @@ ms.author: kgremban
 ms.service: azure-arc
 #ms.subservice: site-manager
 ms.topic: how-to #Don't change
-ms.date: 03/24/2024
+ms.date: 04/18/2024
 
 # As a site admin, I want to know how to view update status so that I can use my site.
 
@@ -17,19 +17,19 @@ This article details how to view the connectivity status for an Arc site. A site
 
 ## Prerequisites
 
+* An Azure subscription. If you don't have a service subscription, create a [free trial account in Azure](https://azure.microsoft.com/free/).
 * Azure portal access
 * Internet connectivity
-* Subscription
-* Resource group or subscription with at least one resource for a site
-* A site created for the associated resource group or subscription
+* A resource group or subscription in Azure with at least one resource for a site. For more information, see [Supported resource types](./overview.md#supported-resource-types).
+* A site created for the associated resource group or subscription. If you don't have one, see [Create and manage sites](./how-to-crud-site.md).
 
 ## Connectivity status colors and meanings
 
 In the Azure portal, status is indicated using color.
 
-* Red: **Needs Attention**
-* Yellow: **Not Connected Recently**
 * Green: **Connected**
+* Yellow: **Not Connected Recently**
+* Red: **Needs Attention**
 
 ## View connectivity status
 
@@ -41,20 +41,20 @@ 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 important resource-level status for the site.
+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 important status.
+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.
 
    :::image type="content" source="./media/how-to-view-connectivity-status/los-angeles-resource-status-connectivity.png" alt-text="Screenshot that shows using the site details page to identify resources with connectivity issues." lightbox="./media/how-to-view-connectivity-status/los-angeles-resource-status-connectivity.png":::