edits

Author: v-albemi

articles/machine-learning/includes/sdk-v1-deprecation.md

@@ -7,6 +7,6 @@ ms.author: larryfr
 ---
 
 > [!IMPORTANT]
-> This article provides information on using the Azure Machine Learning SDK v1. The SDK v1 is deprecated as of March 31, 2025 and support for it will end on June 30, 2026. You're able to install and use the SDK v1 until that date.
+> This article provides information on using the Azure Machine Learning SDK v1. SDK v1 is deprecated as of March 31, 2025. Support for it will end on June 30, 2026. You can install and use SDK v1 until that date.
 >
-> We recommend that you transition to the SDK v2 before June 30, 2026. For more information on the SDK v2, see [What is the Azure Machine Learning Python SDK v2](/azure/machine-learning/concept-v2) and the [SDK v2 reference](/python/api/overview/azure/ai-ml-readme).
+> We recommend that you transition to the SDK v2 before June 30, 2026. For more information on SDK v2, see [What is Azure Machine Learning CLI and Python SDK v2?](/azure/machine-learning/concept-v2) and the [SDK v2 reference](/python/api/overview/azure/ai-ml-readme).

articles/machine-learning/v1/how-to-use-pipeline-parameter.md

@@ -1,7 +1,7 @@
 ---
-title: Use pipeline parameters to build versatile pipelines
+title: Use Pipeline Parameters to Build Versatile Pipelines
 titleSuffix: Azure Machine Learning
-description: How to use pipeline parameters in Azure Machine Learning designer.
+description: Use pipeline parameters in the Azure Machine Learning designer.
 services: machine-learning
 ms.service: azure-machine-learning
 ms.subservice: mlops
@@ -11,22 +11,24 @@ ms.reviewer: keli19
 ms.date: 06/12/2025
 ms.topic: how-to
 ms.custom: UpdateFrequency5, designer
+
+#customer intent: As a machine learning engineer, I want to use pipleline parameters so that I can dynamically set parameter values at runtime.
 ---
 
 # Use pipeline parameters in the designer to build versatile pipelines
 
 [!INCLUDE [v1 deprecation](../includes/sdk-v1-deprecation.md)]
 
-Use pipeline parameters to build flexible pipelines in the designer. Pipeline parameters let you dynamically set values at runtime to encapsulate pipeline logic and reuse assets.
+This article describes how to use pipeline parameters to build flexible pipelines in the Azure Machine Learning designer. Pipeline parameters enable you to dynamically set values at runtime so you can encapsulate pipeline logic and reuse assets.
 
-Pipeline parameters are especially useful when resubmitting a pipeline job, [retraining models](how-to-retrain-designer.md), or [performing batch predictions](how-to-run-batch-predictions-designer.md).
+Pipeline parameters are especially useful when you resubmit a pipeline job, [retrain models](how-to-retrain-designer.md), or [perform batch predictions](how-to-run-batch-predictions-designer.md).
 
 In this article, you learn how to do the following:
 
 > [!div class="checklist"]
-> * Create pipeline parameters
-> * Delete and manage pipeline parameters
-> * Trigger pipeline jobs while adjusting pipeline parameters
+> * Create pipeline parameters.
+> * Delete and manage pipeline parameters.
+> * Supply pipeline paramenters when you trigger pipeline jobs.
 
 ## Prerequisites
 
@@ -35,97 +37,95 @@ In this article, you learn how to do the following:
 * For a guided introduction to the designer, complete the [designer tutorial](tutorial-designer-automobile-price-train-score.md). 
 
 > [!IMPORTANT]
-> If you do not see graphical elements mentioned in this document, such as buttons in studio or designer, you may not have the right level of permissions to the workspace. Please contact your Azure subscription administrator to verify that you have been granted the correct level of access. For more information, see [Manage users and roles](../how-to-assign-roles.md).
+> If you don't see the UI elements mentioned in this article, such as buttons in studio or designer, you might not have the right level of permissions for the workspace. Contact your Azure subscription administrator to verify that you're granted the correct level of access. For more information, see [Manage users and roles](../how-to-assign-roles.md).
 
-## Create pipeline parameter
+## Create a pipeline parameter
 
 There are three ways to create a pipeline parameter in the designer:
-- Create a pipeline parameter in the settings panel, and bind it to a component.
+- Create a pipeline parameter in the settings panel and bind it to a component.
 - Promote a component parameter to a pipeline parameter.
-- Promote a dataset to a pipeline parameter
+- Promote a dataset to a pipeline parameter.
 
 > [!NOTE]
-> Pipeline parameters only support basic data types like `int`, `float`, and `string`.
+> Pipeline parameters support only basic data types, like `int`, `float`, and `string`.
 
 ### Option 1: Create a pipeline parameter in the settings panel
 
 In this section, you create a pipeline parameter in the settings panel.
 
-In this example, you create a pipeline parameter that defines how a pipeline fills in missing data using the **Clean missing data** component.
-
-1. Next to the name of your pipeline draft, select the **gear icon** to open the **Settings** panel.
+In this example, you create a pipeline parameter that defines how a pipeline fills in missing data by using the **Clean missing data** component.
 
-1. In the **Pipeline parameters** section, select the **+** icon.
+1. Next to the name of your pipeline draft, select the gear button to open the **Settings** panel.
 
-1.  Enter a name for the parameter and a default value. 
+1. In the **Pipeline parameters** section, select the **+** button.
 
-    For example, enter `replace-missing-value` as parameter name and `0` as default value.
+1. Enter a name for the parameter and a default value. 
 
-   ![Screenshot that shows how to create a pipeline parameter](media/how-to-use-pipeline-parameter/create-pipeline-parameter.png)
+   For example, enter `replace-missing-value` as parameter name and `0` as the default value.
 
+   :::image type="content" source="media/how-to-use-pipeline-parameter/create-pipeline-parameter.png" alt-text="Screenshot that shows how to create a pipeline parameter." lightbox ="media/how-to-use-pipeline-parameter/create-pipeline-parameter.png":::
 
 After you create a pipeline parameter, you must [attach it to the component parameter](#attach-component-parameter-to-pipeline-parameter) that you want to dynamically set.
 
 ### Option 2: Promote a component parameter
 
-The simplest way to create a pipeline parameter for a component value is to promote a component parameter. Use the following steps to promote a component parameter to a pipeline parameter:
+The easiest way to create a pipeline parameter for a component value is to promote a component parameter. Use the following steps to promote a component parameter to a pipeline parameter:
 
 1. Select the component you want to attach a pipeline parameter to.
-1. In the component detail pane, mouseover the parameter you want to specify.
-1. Select the ellipses (**...**) that appear.
+1. In the component detail pane, hover over the parameter you want to specify.
+1. Select the ellipsis button (**...**) that appears.
 1. Select **Add to pipeline parameter**.
 
-    ![Screenshot that shows how to promote component parameter to pipeline parameter1](media/how-to-use-pipeline-parameter/promote-module-para-to-pipeline-para.png)
+   :::image type="content" source="media/how-to-use-pipeline-parameter/promote-module-para-to-pipeline-para.png" alt-text="Screenshot that shows how to promote a component parameter to a pipeline parameter." lightbox ="media/how-to-use-pipeline-parameter/promote-module-para-to-pipeline-para.png":::
 
-1. Enter a parameter name and default value.
-1. Select **Save**
+1. Enter a parameter name and a default value.
+1. Select **Save**.
 
-You can now specify new values for this parameter anytime you submit this pipeline.
+You can now specify new values for this parameter anytime you submit the pipeline.
 
 ### Option 3: Promote a dataset to a pipeline parameter
 
-If you want to submit your pipeline with variable datasets, you must promote your dataset to a pipeline parameter:
+If you want to submit your pipeline with variable datasets, you need to promote your dataset to a pipeline parameter:
 
 1. Select the dataset you want to turn into a pipeline parameter.
 
-1. In the detail panel of dataset, check **Set as pipeline parameter**.
+1. In the details pane of the dataset, select **Set as pipeline parameter**.
 
-   ![Screenshot that shows how to set dataset as pipeline parameter](media/how-to-use-pipeline-parameter/set-dataset-as-pipeline-parameter.png)
+   :::image type="content" source="media/how-to-use-pipeline-parameter/set-dataset-as-pipeline-parameter.png" alt-text="Screenshot that shows how to set dataset as pipeline parameter." lightbox ="media/how-to-use-pipeline-parameter/set-dataset-as-pipeline-parameter.png":::
 
 You can now specify a different dataset by using the pipeline parameter the next time you run the pipeline.
 
-## Attach and detach component parameter to pipeline parameter 
+## Attach a component parameter to or detach a component pipeline from a pipeline parameter 
 
-In this section, you will learn how to attach and detach component parameter to pipeline parameter.
+In this section, you learn how to attach a component parameter to a pipeline parameter and how to detach a component parameter from a pipeline parameter.
 
 ### Attach component parameter to pipeline parameter
 
-You can attach the same component parameters of duplicated components to the same pipeline parameter if you want to alter the value at one time when triggering the pipeline job.
+You can attach the component parameters of duplicated components to the same pipeline parameter if you want to alter the value one time when you trigger the pipeline job.
 
-The following example has duplicated **Clean Missing Data** component. For each **Clean Missing Data** component, attach **Replacement value** to pipeline parameter **replace-missing-value**:
+In the following example, the **Clean Missing Data** component is duplicated. For each **Clean Missing Data** component, attach a **Replacement value** to the pipeline parameter **replace-missing-value**:
 
 1. Select the **Clean Missing Data** component.
 
-1. In the component detail pane, to the right of the canvas, set the **Cleaning mode** to "Custom substitution value".
+1. In the component detail pane, to the right of the canvas, set the **Cleaning mode** to **Custom substitution value**.
 
-1. Mouseover the **Replacement value** field.
+1. Hover over the **Replacement value** field.
 
-1. Select the ellipses (**...**) that appear.
+1. Select the ellipsis button (**...**) that appears.
 
 1. Select the pipeline parameter `replace-missing-value`.
 
-   ![Screenshot that shows how to attach a pipeline parameter](media/how-to-use-pipeline-parameter/attach-replace-value-to-pipeline-parameter.png)
+   :::image type="content" source="media/how-to-use-pipeline-parameter/attach-replace-value-to-pipeline-parameter.png" alt-text="Screenshot that shows how to attach a pipeline parameter." lightbox ="media/how-to-use-pipeline-parameter/attach-replace-value-to-pipeline-parameter.png":::
 
 You have successfully attached the **Replacement value** field to your pipeline parameter. 
 
+### Detach a component parameter from a pipeline parameter
 
-### Detach component parameter to pipeline parameter
-
-After you attach **Replacement value** to pipeline parameter, it is non-actionable.
+When you detach a **Replacement value** from a pipeline parameter, it's not actionable.
 
-You can detach component parameter to pipeline parameter by clicking the ellipses (**...**) next to the component parameter, and select **Detach from pipeline parameter**.
+You can detach a component parameter from a pipeline parameter by selecting the ellipsis button (**...**) next to the component parameter and then selecting **Detach from pipeline parameter**.
 
- ![Screenshot that shows non-actionable after attaching to pipeline parameter](media/how-to-use-pipeline-parameter/non-actionable-module-parameter.png)
+:::image type="content" source="media/how-to-use-pipeline-parameter/non-actionable-module-parameter.png" alt-text="Screenshot that shows how to detach a component parameter." lightbox ="media/how-to-use-pipeline-parameter/non-actionable-module-parameter.png":::
 
 ## Update and delete pipeline parameters