edit pass: set-up-alert-rules

Author: ShawnJackson

articles/azure-monitor/alerts/alerts-create-activity-log-alert-rule.md

@@ -41,7 +41,7 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
     - **Signal type**: The [type of alert rule](alerts-overview.md#types-of-alerts) that you're creating.
     - **Signal source**: The service that sends the signal.
 
-    This table describes the services available for activity log alert rules:
+    This table describes the available services for activity log alert rules:
 
     | Signal source            | Description                                                     |
     |--------------------------|-----------------------------------------------------------------|
@@ -57,7 +57,7 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
 
     1. On the **Conditions** pane, select the **Chart period** value.
 
-       The **Preview** chart shows you the results of your selection.
+       The **Preview** chart shows the results of your selection.
     1. In the **Alert logic** section, select values for each of these fields:
 
         |Field |Description |
@@ -68,7 +68,7 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
 
     #### [Resource health alert](#tab/resource-health)
 
-    1. On the **Conditions** pane, select values for each of these fields:
+    - On the **Conditions** pane, select values for each of these fields:
 
        |Field |Description |
        |---------|---------|
@@ -79,7 +79,7 @@ Alerts triggered by these alert rules contain a payload that uses the [common al
 
     #### [Service health alert](#tab/service-health)
 
-    1. On the **Conditions** pane, select values for each of these fields:
+    - On the **Conditions** pane, select values for each of these fields:
 
       |Field |Description |
       |---------|---------|

articles/azure-monitor/includes/alerts-wizard-access.md

@@ -8,18 +8,20 @@ author: AbbyMSFT
 
 ## Access the alert rule wizard in the Azure portal
 
-There are several ways that you can create or edit a new alert rule.
+There are multiple ways to create or edit an alert rule.
 
 ### Create or edit an alert rule from the portal home page
 
-1. In the [portal](https://portal.azure.com/), select **Monitor** > **Alerts**.
-1. Open the **+ Create** menu, and select **Alert rule**.
+1. In the [Azure portal](https://portal.azure.com/), select **Monitor**.
+1. On the left pane, select **Alerts**.
+1. Select  **+ Create** > **Alert rule**.
 
-    :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-create-new-alert-rule.png" alt-text="Screenshot that shows steps to create a new alert rule.":::
+:::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-create-new-alert-rule.png" alt-text="Screenshot that shows steps to create an alert rule from the portal home page.":::
 
 ### Create or edit an alert rule from a specific resource
 
-1. In the [portal](https://portal.azure.com/), go to the resource.
-1. Select **Alerts** on the left pane, and then select **+ Create** > **Alert rule**.
+1. In the [Azure portal](https://portal.azure.com/), go to the resource.
+1. On the left pane, select **Alerts**.
+1. Select **+ Create** > **Alert rule**.
 
-     :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-create-new-alert-rule-2.png" alt-text="Screenshot that shows steps to create a new alert rule from a selected resource.":::
+:::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-create-new-alert-rule-2.png" alt-text="Screenshot that shows steps to create an alert rule from a selected resource.":::

articles/azure-monitor/includes/alerts-wizard-actions.md

@@ -8,6 +8,6 @@ author: AbbyMSFT
 
 ## Configure the alert rule actions
 
-1. On the **Actions** tab, select or create the required [action groups](../alerts/action-groups.md).
+On the **Actions** tab, select or create the required [action groups](../alerts/action-groups.md).
 
-    :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-rule-actions-tab.png" alt-text="Screenshot that shows the Actions tab for creating a new alert rule.":::
+:::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-rule-actions-tab.png" alt-text="Screenshot that shows the Actions tab for creating a new alert rule.":::

articles/azure-monitor/includes/alerts-wizard-custom-properties.md

@@ -21,22 +21,18 @@ Use the format of the [common alert schema](../alerts/alerts-common-schema.md) t
 
 :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-rule-custom-props.png" alt-text="Screenshot that shows custom properties for creating a new alert rule.":::
 
-The following examples use values in **Custom properties** to utilize data from a payload that uses the common alert schema:
-
-**Example 1**
+The following examples use values in **Custom properties** to utilize data from a payload that uses the common alert schema.
 
 This example creates an **Additional Details** tag with data regarding the window start time and window end time:
 
 - Name: `Additional Details`
 - Value: `Evaluation windowStartTime: \${data.alertContext.condition.windowStartTime}. windowEndTime: \${data.alertContext.condition.windowEndTime}`
 - Result: `AdditionalDetails:Evaluation windowStartTime: 2023-04-04T14:39:24.492Z. windowEndTime: 2023-04-04T14:44:24.492Z`
 
-**Example 2**
-
 This example adds data regarding the reason for resolving or firing the alert:
 
 - Name: `Alert \${data.essentials.monitorCondition} reason`
 - Value: `\${data.alertContext.condition.allOf[0].metricName} \${data.alertContext.condition.allOf[0].operator} \${data.alertContext.condition.allOf[0].threshold} \${data.essentials.monitorCondition}. The value is \${data.alertContext.condition.allOf[0].metricValue}`
-- Result: Example results could be something like:
+- Potential results:
     - `Alert Resolved reason: Percentage CPU GreaterThan5 Resolved. The value is 3.585`
     - `Alert Fired reason": "Percentage CPU GreaterThan5 Fired. The value is 10.585`

articles/azure-monitor/includes/alerts-wizard-finish.md

@@ -8,9 +8,9 @@ author: AbbyMSFT
 
 ## Configure alert rule tags
 
-1. On the **Tags** tab, set any required tags on the alert rule resource.
+On the **Tags** tab, set any required tags on the alert rule resource.
 
-    :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-rule-tags-tab.png" alt-text="Screenshot that shows the Tags tab for creating a new alert rule.":::
+:::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-rule-tags-tab.png" alt-text="Screenshot that shows the Tags tab for creating a new alert rule.":::
 
 ## Review and create the alert rule
 

articles/azure-monitor/includes/alerts-wizard-scope.md

@@ -9,6 +9,6 @@ author: AbbyMSFT
 ## Configure the scope of the alert rule
 
 1. On the **Select a resource** pane, set the scope for your alert rule. You can filter by subscription, resource type, or resource location.
-1. Select **Apply**.
 
     :::image type="content" source="../alerts/media/alerts-create-new-alert-rule/alerts-select-resource.png" alt-text="Screenshot that shows the pane for selecting a resource during the creation of a new alert rule.":::
+1. Select **Apply**.