Merge pull request #310605 from whhender/uuf-clarity-for-parameters

User feedback - clarity for parameters

Author: v-shils

articles/data-factory/control-flow-append-variable-activity.md

@@ -17,16 +17,16 @@ Use the Append Variable activity to add a value to an existing array variable de
 
 ## Create an Append Variable activity with UI
 
-To use a Append Variable activity in a pipeline, complete the following steps:
+To use an Append Variable activity in a pipeline, complete the following steps:
 
 1. Select the background of the pipeline canvas and use the Variables tab to add an array type variable:
 
-   :::image type="content" source="media/control-flow-activities-common/add-pipeline-array-variable.png" alt-text="Shows an empty pipeline canvas with the Variables tab selected having an array type variable named TestVariable.":::
+    :::image type="content" source="media/control-flow-activities-common/add-pipeline-array-variable.png" alt-text="Shows an empty pipeline canvas with the Variables tab selected having an array type variable named TestVariable.":::
 
-2. Search for _Append Variable_ in the pipeline Activities pane, and drag an Append Variable activity to the pipeline canvas.
+1. Search for _Append Variable_ in the pipeline Activities pane, and drag an Append Variable activity to the pipeline canvas.
 1. Select the Append Variable activity on the canvas if it isn't already selected, and its  **Variables** tab, to edit its details.
 1. Select the variable for the Name property.
-1. Enter an expression for the value, which is appended to the array in the variable. This can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+1. Enter an expression for the value, which is appended to the array in the variable. This can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 
    :::image type="content" source="media/control-flow-append-variable-activity/append-variable.png" alt-text="Shows the UI for an Append Variable activity.":::
 

articles/data-factory/control-flow-fail-activity.md

@@ -25,7 +25,7 @@ To use a Fail activity in a pipeline, complete the following steps:
 
    :::image type="content" source="media/control-flow-fail-activity/fail-activity.png" alt-text="Shows the UI for a Fail activity.":::
 
-1. Enter a failure message and error code. These values can be literal string expressions, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+1. Enter a failure message and error code. These values can be literal string expressions, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 
 ## Syntax
 

articles/data-factory/control-flow-filter-activity.md

@@ -31,7 +31,7 @@ You can use a Filter activity in a pipeline to apply a filter expression to an i
 
 To use a Filter activity in a pipeline, complete the following steps:
 
-1. You can use any array type variable or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions) as the input for your filter condition.  To create an array variable, select the background of the pipeline canvas and then select the **Variables** tab to add an array type variable as shown below.
+1. You can use any array type variable or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters) as the input for your filter condition.  To create an array variable, select the background of the pipeline canvas and then select the **Variables** tab to add an array type variable as shown below.
 
    :::image type="content" source="media/control-flow-activities-common/pipeline-array-variable.png" alt-text="Shows an empty pipeline canvas with an array type variable added to the pipeline.":::
 

articles/data-factory/control-flow-for-each-activity.md

@@ -20,7 +20,7 @@ The ForEach Activity defines a repeating control flow in an Azure Data Factory o
 
 To use a ForEach activity in a pipeline, complete the following steps:
 
-1. You can use any array type variable or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions) as the input for your ForEach activity.  To create an array variable, select the background of the pipeline canvas and then select the **Variables** tab to add an array type variable as shown below.
+1. You can use any array type variable or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters) as the input for your ForEach activity.  To create an array variable, select the background of the pipeline canvas and then select the **Variables** tab to add an array type variable as shown below.
 
    :::image type="content" source="media/control-flow-activities-common/pipeline-array-variable.png" alt-text="Shows an empty pipeline canvas with an array type variable added to the pipeline.":::
 

articles/data-factory/control-flow-if-condition-activity.md

@@ -28,7 +28,7 @@ To use an If Condition activity in a pipeline, complete the following steps:
 
    :::image type="content" source="media/control-flow-if-condition-activity/if-condition-activity.png" alt-text="Shows the UI for an If Condition activity.":::
 
-1. Enter an expression that returns a boolean true or false value. This can be any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+1. Enter an expression that returns a boolean true or false value. This can be any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 1. Select the Edit Activities buttons on the Activities tab for the If Condition, or directly from the If Condition on the pipeline canvas, to add activities that will be executed when the expression evaluates to `true` or `false`.
 
 ## Syntax

articles/data-factory/control-flow-set-variable-activity.md

@@ -32,7 +32,7 @@ To use a Set Variable activity in a pipeline, complete the following steps:
 
 5. Select the variable for the Name property.
 
-6. Enter an expression to set the value for the variables. This expression can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+6. Enter an expression to set the value for the variables. This expression can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 
 :::image type="content" source="media/control-flow-set-variable-activity/set-variable-activity.png" alt-text="Screenshot of the UI for a Set variable activity.":::
 

articles/data-factory/control-flow-switch-activity.md

@@ -23,7 +23,7 @@ The Switch activity provides the same functionality that a switch statement prov
 To use a Switch activity in a pipeline, complete the following steps:
 1. Search for _Switch_ in the pipeline Activities pane, and add a Switch activity to the pipeline canvas.
 1. Select the Switch activity on the canvas if it isn't already selected, and its  **Activities** tab, to edit its details.
-1. Enter an expression for the Switch to evaluate.  This can be any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+1. Enter an expression for the Switch to evaluate.  This can be any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 1. Select **Add case** to add more cases.  If no case matches, the Default case activity is used.
 1. Enter the value for the new case.
 1. Select the Edit button to add activities that are executed when the expression evaluates to the matched case.

articles/data-factory/control-flow-until-activity.md

@@ -28,7 +28,7 @@ To use an Until activity in a pipeline, complete the following steps:
 
    :::image type="content" source="media/control-flow-until-activity/until-activity.png" alt-text="Shows the Settings tab of the Until activity in the pipeline canvas.":::
 
-1. Enter an expression that will be evaluated after all child activities defined in the Until activity is executed. If the expression evaluates to false, the Until activity executes all its child activities again. When it evaluates to true, the Until activity completes. The expression can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions). The example below checks the value of a previously defined pipeline array variable called TestVariable to see if it evaluates to ['done'].
+1. Enter an expression that will be evaluated after all child activities defined in the Until activity is executed. If the expression evaluates to false, the Until activity executes all its child activities again. When it evaluates to true, the Until activity completes. The expression can be a literal string expression, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters). The example below checks the value of a previously defined pipeline array variable called TestVariable to see if it evaluates to ['done'].
 
    :::image type="content" source="media/control-flow-until-activity/dynamic-content-to-check-variable-value.png" alt-text="Shows the  Add dynamic content  pane with an expression to check a variable for a defined value.":::
 

articles/data-factory/control-flow-wait-activity.md

@@ -24,7 +24,7 @@ To use a Wait activity in a pipeline, complete the following steps:
 
    :::image type="content" source="media/control-flow-wait-activity/wait-activity.png" alt-text="Shows the UI for a Wait activity.":::
 
-1. Enter a number of seconds for the activity to wait. This can be a literal number, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#examples-of-using-parameters-in-expressions).
+1. Enter a number of seconds for the activity to wait. This can be a literal number, or any combination of dynamic [expressions, functions](control-flow-expression-language-functions.md), [system variables](control-flow-system-variables.md), or [outputs from other activities](how-to-expression-language-functions.md#expressions-with-parameters).
 
 ## Syntax