Merge pull request #248901 from ecfan/ecfan-patch-1

Azure Logic Apps: Conditions - Clarity edits

Author: v-dirichards

articles/logic-apps/logic-apps-control-flow-conditional-statement.md

@@ -1,6 +1,6 @@
 ---
 title: Add conditions to workflows
-description: Create conditions that control actions in workflows in Azure Logic Apps.
+description: Create conditions that control workflow actions in Azure Logic Apps.
 services: logic-apps
 ms.suite: integration
 ms.reviewer: estfan, azla
@@ -12,17 +12,18 @@ ms.date: 08/08/2023
 
 [!INCLUDE [logic-apps-sku-consumption-standard](../../includes/logic-apps-sku-consumption-standard.md)]
 
-To specify a condition that returns either true or false and have your workflow run either one action path or another based on the result, add the **Control** action named **Condition** to your workflow. You can nest conditions inside each other.
+When you want to set up a condition that returns true or false and have the result determine whether your workflow runs one path of actions or another, add the **Control** action named **Condition** to your workflow. You can also nest conditions inside each other.
 
 For example, suppose you have a workflow that sends too many emails when new items appear on a website's RSS feed. 
 You can add the **Condition** action to send email only when the new item includes a specific word.
 
 > [!NOTE]
 >
-> To specify more than two paths from which your workflow can choose or if the condition criteria isn't restricted 
-> to only true or false, use a [*switch statement* instead](logic-apps-control-flow-switch-statement.md).
+> If you want to specify more than two paths from which your workflow can choose
+> or condition criteria that's not restricted to only true or false, use a
+> [*switch action* instead](logic-apps-control-flow-switch-statement.md).
 
-This how-to guide shows how to add a condition to your workflow and use the result to help your workflow choose from two action paths.
+This guide shows how to add a condition to your workflow and use the result to help your workflow choose between two action paths.
 
 ## Prerequisites
 
@@ -36,39 +37,39 @@ This how-to guide shows how to add a condition to your workflow and use the resu
 
 ### [Consumption](#tab/consumption)
 
-1. In the [Azure portal](https://portal.azure.com), open your Consumption logic app workflow in the designer.
+1. In the [Azure portal](https://portal.azure.com), open your logic app workflow in the designer.
 
 1. [Follow these general steps to add the **Condition** action to your workflow](create-workflow-with-trigger-or-action.md?tabs=consumption#add-action).
 
-1. In the **Condition** action, follow these steps build your condition:
+1. In the **Condition** action, follow these steps to build your condition:
 
-   1. In the left **Choose a value** box, specify the first value or field that you want to compare.
+   1. In the left-side box named **Choose a value**, enter the first value or field that you want to compare.
 
-      When you select inside the left box, the dynamic content list opens so that you can select outputs from previous steps in your workflow.
+      When you select inside the **Choose a value** box, the dynamic content list opens automatically. From this list, you can select outputs from previous steps in your workflow.
 
       This example selects the RSS trigger output named **Feed summary**.
 
       ![Screenshot shows Azure portal, Consumption workflow designer. RSS trigger, and Condition action with criteria construction.](./media/logic-apps-control-flow-conditional-statement/edit-condition-consumption.png)
 
-   1. From the middle list, select the operation to perform.
+   1. Open the middle list, select the operation to perform.
 
       This example selects **contains**.
 
-   1. In the right **Choose a value** box, specify the value or field that you want to compare with the first.
+   1. In the right-side box named **Choose a value**, enter the value or field that you want to compare with the first.
 
       This example specifies the following string: **Microsoft**
 
-   The following example shows the complete condition:
+   The complete condition now looks like the following example:
 
    ![Screenshot shows the Consumption workflow and the complete condition criteria.](./media/logic-apps-control-flow-conditional-statement/complete-condition-consumption.png)
 
-   - To add another row to your condition, open the **Add** menu, and select **Add row**.
+   - To add another row to your condition, from the **Add** menu, select **Add row**.
 
-   - To add a group with subconditions, open the **Add** menu, and select **Add group**.
+   - To add a group with subconditions, from the **Add** menu, select **Add group**.
 
    - To group existing rows, select the checkboxes for those rows, select the ellipses (...) button for any row, and then select **Make group**.
 
-1. In the **True** and **False** action paths, add the actions to run based on whether the condition is true or false, respectively, for example:
+1. In the **True** and **False** action paths, add the actions that you want to run, based on whether the condition is true or false respectively, for example:
 
    ![Screenshot shows the Consumption workflow and the condition with true and false paths.](./media/logic-apps-control-flow-conditional-statement/condition-true-false-path-consumption.png)
 
@@ -80,13 +81,19 @@ This how-to guide shows how to add a condition to your workflow and use the resu
 
 ### [Standard](#tab/standard)
 
-1. In the [Azure portal](https://portal.azure.com), open your Standard logic app workflow in the designer.
+1. In the [Azure portal](https://portal.azure.com), open your logic app workflow in the designer.
 
 1. [Follow these general steps to add the **Condition** action to your workflow](create-workflow-with-trigger-or-action.md?tabs=standard#add-action).
 
-1. On the designer, select the **Condition** action to open the information pane and follow these steps build your condition:
+1. On the designer, select the **Condition** action to open the information pane. Follow these steps to build your condition:
+
+   1. In the left-side box named **Choose a value**, enter the first value or field that you want to compare.
+
+      After you select inside the **Choose a value** box, the options to open the dynamic content list (lightning icon) or expression editor (formula icon) appear.
+
+   1. Select the lightning icon to open the dynamic content list.
 
-   1. In the left **Choose a value** box, specify the first value or field that you want to compare. When you select inside the left box, select the lightning button that appears to open the dynamic content list so that you can select outputs from previous steps in your workflow.
+      From this list, you can select outputs from previous steps in your workflow.
 
       ![Screenshot shows Azure portal, Standard workflow designer, RSS trigger, and Condition action with information pane open, and dynamic content button selected.](./media/logic-apps-control-flow-conditional-statement/open-dynamic-content-standard.png)
 
@@ -98,21 +105,21 @@ This how-to guide shows how to add a condition to your workflow and use the resu
 
       This example selects **contains**.
 
-   1. In the right **Choose a value** box, specify the value or field that you want to compare with the first.
+   1. In the right-side box named **Choose a value**, enter the value or field that you want to compare with the first.
 
       This example specifies the following string: **Microsoft**
 
    The following example shows the complete condition:
 
    ![Screenshot shows the Standard workflow and the complete condition criteria.](./media/logic-apps-control-flow-conditional-statement/complete-condition-standard.png)
 
-   - To add another row to your condition, open the **New item** menu, and select **Add Row**.
+   - To add another row to your condition, from the **New item** menu, select **Add Row**.
 
-   - To add a group with subconditions, open the **New item** menu, and select **Add Group**.
+   - To add a group with subconditions, from the **New item** menu, select **Add Group**.
 
    - To group existing rows, select the checkboxes for those rows, select the ellipses (...) button for any row, and then select **Make Group**.
 
-1. In the **True** and **False** action paths, add the actions to run based on whether the condition is true or false, respectively, for example:
+1. In the **True** and **False** action paths, add the actions to run, based on whether the condition is true or false respectively, for example:
 
    ![Screenshot shows the Standard workflow and the condition with true and false paths.](./media/logic-apps-control-flow-conditional-statement/condition-true-false-path-standard.png)
 
@@ -128,7 +135,7 @@ This workflow now sends mail only when the new items in the RSS feed meet your c
 
 ## JSON definition
 
-The following shows the high-level code definition behind the **Condition** action, but for the full definition, see [If action - Schema reference guide for trigger and action types in Azure Logic Apps](logic-apps-workflow-actions-triggers.md#if-action).
+The following code shows the high-level JSON definition for the **Condition** action. For the full definition, see [If action - Schema reference guide for trigger and action types in Azure Logic Apps](logic-apps-workflow-actions-triggers.md#if-action).
 
 ``` json
 "actions": {
@@ -165,4 +172,4 @@ The following shows the high-level code definition behind the **Condition** acti
 * [Run steps based on different values (switch actions)](logic-apps-control-flow-switch-statement.md)
 * [Run and repeat steps (loops)](logic-apps-control-flow-loops.md)
 * [Run or merge parallel steps (branches)](logic-apps-control-flow-branches.md)
-* [Run steps based on grouped action status (scopes)](logic-apps-control-flow-run-steps-group-scopes.md)
+* [Run steps based on grouped action status (scopes)](logic-apps-control-flow-run-steps-group-scopes.md)