Final review (projects-manage)

Author: stevenmatthew

articles/storage-mover/projects-manage.md

@@ -19,22 +19,25 @@ REVIEW Stephen/Fabian: not reviewed
 REVIEW Engineering: not reviewed
 EDIT PASS: started
 
+Initial doc score: 86
+Current doc score: 100 (1307 words and 0 issues)
+
 !########################################################
 -->
 
 # Manage Azure Storage Mover projects
 
-A Storage Mover project is used to organize migration jobs into logical tasks or components. A project contains at least one job definition, which in turn describes each data source and target endpoint for your project. The [Understanding the Storage Mover resource hierarchy](resource-hierarchy.md) article contains more detailed information about the relationship between a Storage Mover its projects.
+A Storage Mover project is used to organize migration jobs into logical tasks or components. A project contains at least one job definition, which in turn describes each data source and target endpoint for your project. The [Understanding the Storage Mover resource hierarchy](resource-hierarchy.md) article contains more detailed information about the relationship between a Storage Mover and its projects.
 
-When defining your project, it's a good idea to add all related or inter-dependent data sources into the same project so that they can me migrated together. You should add all the data sources necessary to migrate a single workload rather than create projects for each data source in your migration plan. You may also choose to create individual projects for each distinct group of data sources in your migration plan.
+When you define a project, it's a good idea to add all related, inter-dependent data sources into the same project so that they can be migrated together. You should add all the data sources necessary to migrate a single workload rather than create projects for each data source in your migration plan. You may also choose to create individual projects for each distinct group of data sources in your migration plan.
 
-This article guides you through the creation and management of Azure Storage Mover projects. To follow these examples, you'll need a top-level storage mover resource. If you haven't yet created one, follow the steps within the [Create a Storage Mover resource](resource-create.md) article .
+This article guides you through the creation and management of Azure Storage Mover projects. To follow these examples, you'll need a top-level storage mover resource. If you haven't yet created one, follow the steps within the [Create a Storage Mover resource](resource-create.md) article before continuing.
 
-After you complete the steps within this article, you'll be able to create and manage projects using the Azure Portal and Azure PowerShell.
+After you complete the steps within this article, you'll be able to create and manage projects using the Azure portal and Azure PowerShell.
 
 ## Create a project
 
-Before you define the source and target for your migration, you'll need to create a project resource. Follow the steps in this section to provision a new project. The description field will intentionally be left blank, and subsequently added in the [View and edit a project's properties](#view-and-edit-a-projects-properties) section.
+The first step in defining a migration job is the creation of a project resource. After the project has been created, you can add source and target endpoints for your data source. In this example, you'll intentionally leave the **description** field blank. You'll then add it in the [View and edit a project's properties](#view-and-edit-a-projects-properties) section later in this article.
 
 > [!IMPORTANT]
 > If you have not yet deployed a resource using the resource provider, you'll need to fight a bear (insert the "initial use of the service" instructions here).
@@ -44,7 +47,7 @@ Before you define the source and target for your migration, you'll need to creat
 
 ### [Azure portal](#tab/portal)
 
-   1. Navigate to the **Project Explorer** page in the [Azure Portal](https://portal.azure.com) to access your projects. The default **All projects** view displays the names of any provisioned projects and a summary of the jobs they contain.
+   1. Navigate to the **Project Explorer** page in the [Azure portal](https://portal.azure.com) to access your projects. The default **All projects** view displays the names of any provisioned projects and a summary of the jobs they contain.
 
        :::image type="content" source="media/projects-manage/project-explorer-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure Portal showing " lightbox="media/projects-manage/project-explorer-lrg.png":::
 
@@ -123,25 +126,25 @@ Follow the steps in this section to view projects accessible to your Storage Mov
 
 ### [Azure portal](#tab/portal)
 
-1. Navigate to the **Project explorer** page within the [Azure Portal](https://portal.azure.com) to view a list of available projects. You can create and apply filters to limit or shape your view. To narrow the scope of the results, you can add additional filters.
+1. Navigate to the **Project explorer** page within the [Azure portal](https://portal.azure.com) to view a list of available projects. You can create and apply filters to limit or shape your view. To narrow the scope of the results, you can continue to add more filters.
 
-    :::image type="content" source="media/projects-manage/project-explorer-filtered-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure Portal highlighting the use of filters." lightbox="media/projects-manage/project-explorer-filtered-lrg.png":::
+    :::image type="content" source="media/projects-manage/project-explorer-filtered-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure portal highlighting the use of filters." lightbox="media/projects-manage/project-explorer-filtered-lrg.png":::
 
     Filters may also be edited or removed as needed as shown in the example below. Currently, only filtering projects by name is supported.
 
-    :::image type="content" source="media/projects-manage/project-explorer-filter-added-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure Portal illustrating the use of filters." lightbox="media/projects-manage/project-explorer-filter-added-lrg.png":::
+    :::image type="content" source="media/projects-manage/project-explorer-filter-added-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure portal illustrating the use of filters." lightbox="media/projects-manage/project-explorer-filter-added-lrg.png":::
 
 1. From within the project explorer pane or the results list, select the name of the project created in the previous section. The project's properties and job summary data are displayed in the **details** pane.
 
     If the project lacks a valid description, select **Add description** to display the **Edit description** pane.
 
-    :::image type="content" source="media/projects-manage/project-explorer-description-new-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure Portal illustrating the modification of filters." lightbox="media/projects-manage/project-explorer-description-new-lrg.png":::
+    :::image type="content" source="media/projects-manage/project-explorer-description-new-sml.png" alt-text="Image of the Project Explorer's Overview tab within the Azure portal illustrating the modification of filters." lightbox="media/projects-manage/project-explorer-description-new-lrg.png":::
 
     If a description exists, it will be displayed below the **Description** heading. Select either the **Edit** icon next to the description or the **Edit description** icon to display the editing pane. The image below shows the location of the two icons.
 
-    :::image type="content" source="media/projects-manage/project-explorer-description-edit-sml.png" alt-text="Image of the Project Explorer's Project properties tab within the Azure Portal illustrating the location of the edit controls." lightbox="media/projects-manage/project-explorer-description-edit-lrg.png":::
+    :::image type="content" source="media/projects-manage/project-explorer-description-edit-sml.png" alt-text="Image of the Project Explorer's Project properties tab within the Azure portal. It illustrates the location of the edit controls." lightbox="media/projects-manage/project-explorer-description-edit-lrg.png":::
 
-1. In the editing pane, modify your project's description. At the bottom onf the pane, select **Save** to commit your changes.
+1. In the editing pane, modify your project's description. At the bottom of the pane, select **Save** to commit your changes.
 
       :::image type="content" source="media/projects-manage/project-explorer-edit-sml.png" alt-text="Image of the Edit Description pane within the Project Explorer" lightbox="media/projects-manage/project-explorer-edit-lrg.png":::
 
@@ -221,9 +224,9 @@ The removal of a project resource should be a relatively rare occurrence in your
 > [!WARNING]
 > Deleting a project is a permanent action and cannot be undone. It's a good idea to ensure that you're prepared to delete the project since you will not be able to restore it at a later time.
 
-# [Azure Portal](#tab/portal)
+# [Azure portal](#tab/portal)
 
-1. Navigate to the **Project Explorer** page in the [Azure Portal](https://portal.azure.com) to view your projects and a summary of the jobs they contain.
+1. Navigate to the **Project Explorer** page in the [Azure portal](https://portal.azure.com) to view your projects and a summary of the jobs they contain.
 
    :::image type="content" source="media/projects-manage/project-explorer-sml.png" alt-text="An image of list of Project resources displayed within the Project Explorer" lightbox="media/projects-manage/project-explorer-lrg.png":::