changes

Author: v-thepet

articles/machine-learning/concept-designer.md

@@ -16,17 +16,17 @@ ms.custom: designer
 
 Designer in Azure Machine Learning studio is a drag-and-drop user interface for building machine learning pipelines in Azure Machine Learning workspaces.
 
-## Classic prebuilt (v1) or custom (v2) assets
+The following animated GIF shows how you can build a pipeline visually in Designer by dragging and dropping assets and connecting them.
 
-Designer supports two types of pipeline elements: classic prebuilt (v1) or custom (v2). These two types aren't compatible in pipelines. *This article applies to custom components.*
+:::image type="content" source="./media/concept-designer/designer-drag-and-drop.gif" alt-text="GIF of a building a pipeline in the designer." lightbox= "./media/concept-designer/designer-drag-and-drop.gif":::
 
-- **Classic prebuilt components (v1)** support typical data processing and machine learning tasks like regression and classification. Azure Machine Learning continues to support the existing classic prebuilt components, but no new prebuilt components are being added. For information about classic prebuilt components and Designer (v1), see [Azure Machine Learning designer (v1)](https://learn.microsoft.com/azure/machine-learning/concept-designer?view=azureml-api-1&preserve-view=true).
+## Classic prebuilt (v1) or custom (v2) components
 
-- **Custom components (v2)** let you wrap your own code as components, enabling sharing across workspaces and seamless authoring across Azure Machine Learning studio, CLI v2, and SDK v2 interfaces. It's best to use custom components for new projects, because they're compatible with Azure Machine Learning v2 and continue to receive new updates.
+Designer supports two types of pipeline components: classic prebuilt (v1) or custom (v2). These two types aren't compatible in pipelines. *This article applies to custom components.*
 
-The following animated GIF shows how you can build a pipeline visually in Designer by dragging and dropping assets and connecting them.
+- **Classic prebuilt components (v1)** support typical data processing and machine learning tasks like regression and classification. Azure Machine Learning continues to support the existing classic prebuilt components, but no new prebuilt components are being added. For information about classic prebuilt components and Designer (v1), see [Azure Machine Learning designer (v1)](https://learn.microsoft.com/azure/machine-learning/concept-designer?view=azureml-api-1&preserve-view=true).
 
-:::image type="content" source="./media/concept-designer/designer-drag-and-drop.gif" alt-text="GIF of a building a pipeline in the designer." lightbox= "./media/concept-designer/designer-drag-and-drop.gif":::
+- **Custom components (v2)** let you wrap your own code as components, enabling sharing across workspaces and seamless authoring across Azure Machine Learning studio, CLI v2, and SDK v2 interfaces. It's best to use custom components for new projects, because they're compatible with Azure Machine Learning v2 and continue to receive new updates.
 
 ## Asset libraries
 
@@ -36,11 +36,11 @@ Designer uses building blocks from Azure Machine Learning asset libraries to cre
  - [Models](how-to-manage-models.md?view=azureml-api-2&preserve-view=true&tabs=cli)
  - [Components](concept-component.md)
 
-The asset libraries on the left side of Designer show assets you create in your workspace and assets shared in all Azure Machine Learning [registries](./how-to-share-models-pipelines-across-workspaces-with-registries.md) that you have access to.
+The asset libraries on the left side of Designer show assets created in your workspace and shared assets in all Azure Machine Learning [registries](./how-to-share-models-pipelines-across-workspaces-with-registries.md) that you have access to.
 
 :::image type="content" source="./media/concept-designer/asset-library.png" alt-text="Screenshot of the asset libraries filtered for one registry." lightbox= "./media/concept-designer/asset-library.png":::
 
-To view assets from specific registries, select the **Registry name** filter above the asset libraries. The assets you create in your current workspace are in the **Workspace** registry. The assets provided by Azure Machine Learning are in the **azureml** registry.
+To view assets from specific registries, select the **Registry name** filter above the asset libraries. The assets you created in your current workspace are in the **Workspace** registry. The assets provided by Azure Machine Learning are in the **azureml** registry.
 
 To learn how to create data and component assets in your workspace, see the following articles:
 
@@ -51,20 +51,20 @@ To learn how to create data and component assets in your workspace, see the foll
 
 You can use Designer to visually build pipelines with your assets. You can either create new pipelines or clone and build on existing pipeline jobs.
 
-### New pipeline
+### New pipelines
 
-Selecting the **+** symbol under **New pipeline** at the top of the Designer screen creates a new pipeline to build from scratch. Be sure to select the **Custom component** option to create the pipeline.
+Selecting the **+** symbol under **New pipeline** at the top of the Designer screen creates a new pipeline to build from scratch. Be sure to select the **Custom** option to create the pipeline with custom components.
 
 :::image type="content" source="./media/concept-designer/new-pipeline.png" alt-text="Screenshot of selecting new pipeline with custom components." lightbox= "./media/concept-designer/new-pipeline.png":::
 
-### Pipeline drafts
-
 The two tabs under **Pipelines** at the bottom of the Designer screen show the existing **Pipeline drafts** and **Pipeline jobs** in your workspace.
 
-:::image type="content" source="./media/concept-designer/pipeline-draft-and-job.png" alt-text="Screenshot of pipeline draft list." lightbox= "./media/concept-designer/pipeline-draft-and-job.png":::
+### Pipeline drafts
 
 As you build a pipeline, Designer saves your progress as a pipeline draft. You can edit a pipeline draft anytime by adding or removing components, configuring compute targets, and setting parameters.
 
+:::image type="content" source="./media/concept-designer/pipeline-draft-and-job.png" alt-text="Screenshot of pipeline draft list." lightbox= "./media/concept-designer/pipeline-draft-and-job.png":::
+
 A valid pipeline draft has the following characteristics:
 
 - Data assets can connect only to components.
@@ -80,7 +80,7 @@ Each time you run a pipeline, the pipeline configuration and results are stored
 
 :::image type="content" source="./media/concept-designer/pipeline-job.png" alt-text="Screenshot of pipeline job list." lightbox= "./media/concept-designer/pipeline-job.png":::
 
-You can edit and resubmit your pipelines. After submitting, you can see the lineage between the job you submit and the original job by selecting **Show lineage** in the job detail page.
+You can edit and resubmit your pipelines. After submitting, you can see the lineage between the job you submit and the original job by selecting **Show lineage** on the job detail page.
 
 :::image type="content" source="./media/concept-designer/resubmitted.png" alt-text="Screenshot showing the resubmitted lineage after selecting Show lineage." lightbox= "./media/concept-designer/resubmitted.png":::