fixing doc review issues

Author: EMaher

articles/lab-services/how-to-manage-vm-pool.md

@@ -5,17 +5,18 @@ ms.topic: how-to
 ms.date: 01/21/2022
 ---
 
-# Manage a VM pool in Lab Services 
+# Manage a VM pool in Lab Services
 
 The **Virtual machine pool** page of a lab allows instructors to set how many VMs are available for use and manage the state of those VMs.
 
-1. Start and stop all the VMs at once.
-1. Start and stop specific VMs.
-1. Redeploy a VM.
-1. Connect to a student's VM.
-1. Change the lab capacity.
+- Start and stop all the VMs at once.
+- Start and stop specific VMs.
+- Redeploy a VM.
+- Connect to a student's VM.
+- Change the lab capacity.
 
 VMs can be in one of a few states.
+
 - **Unassigned**. These VMs aren't assigned to students yet. These VMs won't be started when a schedule runs.
 - **Stopped**. VM is turned off and not available for use.
 - **Starting**.  VM is starting.  It's not yet available for use.
@@ -25,39 +26,39 @@ VMs can be in one of a few states.
 > [!WARNING]
 > Turning on a student VM will not affect the quota for the student. Make sure to stop all VMs manually or using a [schedule](how-to-create-schedules.md) to avoid unexpected costs.
 
-### Manually starting VMs
+## Manually starting VMs
 
 You can start all VMs in a lab by selecting the **Start all** button at the top of the page.
 
-:::image type="content" source="./media/how-to-set-virtual-machine-passwords/start-all-vms-button.png" alt-text="Start your VMs":::
+:::image type="content" source="./media/how-to-set-virtual-machine-passwords/start-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Start all button is highlighted.":::
 
 Individual VMs can be started by clicking the state toggle.  The toggle will read **Starting** as the VM starts up, and then **Running** once the VM has started.  You can also select multiple VMs using the checks to the left of the **Name** column. Once the VMs are checked, select the **Start** button at the top of the screen.
 
-### Manually stopping VMs
+## Manually stopping VMs
 
 You can select the **Stop all** button to stop all of the VMs.
 
-:::image type="content" source="./media/how-to-set-virtual-machine-passwords/stop-all-vms-button.png" alt-text="Stop your VMs":::
+:::image type="content" source="./media/how-to-set-virtual-machine-passwords/stop-all-vms-button.png" alt-text="Screenshot that shows the Virtual machine pool page and the Stop all button is highlighted.":::
 
 Individual VMs can be stopped by clicking the state toggle.  The toggle will read **Stopping** as the VM shuts down, and then **Stopped** once the VM has shutdown.  You can also select multiple VMs using the checks to the left of the **Name** column. Once the VMs are checked, select the **Stop** button at the top of the screen.
 
-### Redeploy VMs
+## Redeploy VMs
 
-If students are facing difficulties accessing their VM, redeploying the VM may provide a resolution for the issue. Redeploying, unlike resetting, doesn't cause the data on the OS to be lost.  When you [redeploy a VM](/azure/virtual-machines/redeploy-to-new-node-windows), Azure Lab Services will shut down the VM, move it to a new host, and restart it.  You can think of it as a refresh of the underlying VM for the student’s machine.  The student doesn’t need to re-register to the lab or do any other action.  Any data you saved in the OS disk (usually C: drive) of the VM will still be available after the redeploy operation.  Anything saved on the temporary disk (usually D: drive) will be lost. 
+If students are facing difficulties accessing their VM, redeploying the VM may provide a resolution for the issue. Redeploying, unlike resetting, doesn't cause the data on the OS to be lost.  When you [redeploy a VM](/troubleshoot/azure/virtual-machines/redeploy-to-new-node-windows), Azure Lab Services will shut down the VM, move it to a new host, and restart it.  You can think of it as a refresh of the underlying VM for the student’s machine.  The student doesn’t need to re-register to the lab or do any other action.  Any data you saved in the OS disk (usually C: drive) of the VM will still be available after the redeploy operation.  Anything saved on the temporary disk (usually D: drive) will be lost.
 
 Both lab owners and lab users can Redeploy a VM.
 
-### Connect to VMs
+## Connect to VMs
 
 Instructors can connect to a student VM as long as it's turned on. Verify the student is *not* connected to the VM first. By connecting to the VM, you can access local files on the VM and help students troubleshoot issues.
 
 To connect to the student VM, hover the mouse on the VM in the list and select the **Connect** button.  For further instructions based on the operating system you're using, see [Connect to the VM](tutorial-connect-lab-virtual-machine.md).
 
-### Set lab capacity
+## Set lab capacity
 
-To change the lab capacity (number of VMs in the lab), select **Lab capacity** on the toolbar and update number of VMs on the **Lab capacity** window on the right. 
+To change the lab capacity (number of VMs in the lab), select **Lab capacity** on the toolbar and update number of VMs on the **Lab capacity** window on the right.
 
-:::image type="content" source="./media/how-to-manage-vm-pool/virtual-machine-pool-update-lab-capacity.png" alt-text="Set number of VMs available for the lab.":::
+:::image type="content" source="./media/how-to-manage-vm-pool/virtual-machine-pool-update-lab-capacity.png" alt-text="Screenshot of Lab capacity window.":::
 
 If using [Teams](how-to-manage-vm-pool-within-teams.md) or [Canvas](how-to-manage-vm-pool-within-canvas.md) integration, lab capacity will automatically be updated when Azure Lab Services syncs the user list.
 

articles/lab-services/includes/lab-services-add-lab-creator.md

@@ -3,6 +3,7 @@ author: EMaher
 ms.author: enewman
 ms.date: 01/21/2022
 ms.topic: include
+ms.service: lab-services
 ---
 
 To create or edit up a lab in the [Azure Lab Services portal](https://labs.azure.com), the instructor must be assigned the **Lab Creator** role on the lab plan.  Assigning **Lab Creator** role on the lab plan's resource group will allow an instructor to use all lab plans in that resource group.
@@ -12,15 +13,15 @@ To create or edit up a lab in the [Azure Lab Services portal](https://labs.azure
 
 1. On the **Overview** page for the lab plan, select **Add lab creators**.
 
-:::image type="content" source="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators-focused.png" alt-text="Screenshot that the **Overview** page of the lab plan." lightbox="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators.png":::
+    :::image type="content" source="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators-focused.png" alt-text="Screenshot that shows the **Overview** page of the lab plan." lightbox="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators.png":::
 
 1. From the **Access control (IAM)** page, select **Add** > **Add role assignment**.
 
-    ![Access control (IAM) page with Add role assignment menu open.](../../../includes/role-based-access-control/media/add-role-assignment-menu-generic.png)
+    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-menu-generic.png" alt-text="Screenshot of the Access control (I A M) page with Add role assignment menu option highlighted.":::
 
 1. On the **Role** tab, select the **Lab Creator** role.
 
-    ![Add role assignment page with Role tab selected.](../../../includes/role-based-access-control/media/add-role-assignment-role-generic.png)
+    :::image type="content" source="../../../includes/role-based-access-control/media/add-role-assignment-role-generic.png" alt-text="Screenshot of Add roll assignment page with Role tab selected.":::
 
 1. On the **Members** tab, select the user you want to add to the **Lab Creators** role.
 1. On the **Review + assign** tab, select **Review + assign** to assign the role.

articles/lab-services/media/quick-create-lab-portal/lab-template-page.png

@@ -23,13 +23,14 @@ To complete this quick start, make sure that you have:
 - Azure subscription.  If you don’t have one, [create a free account](https://azure.microsoft.com/free/) before you begin.
 
 ## Create a lab plan
+
 The following steps show how to use the Azure portal to create a lab plan.
 
-1. In the [Azure portal([https://portal.azure.com), select **Create a resource** at the top left of the screen.
+1. In the [Azure portal](https://portal.azure.com), select **Create a resource** at the top left of the screen.
 1. Select **All services** in the left menu.  Search for **Lab plans**.
 1. Select the **Lab plans (preview)** tile, select **Create**.
 
-:::image type="content" source="./media/quick-create-lab-plan-portal/select-lab-plans-service.png" alt-text="Screenshot that shows the Lab plan tile for Azure Marketplace.":::
+    :::image type="content" source="./media/quick-create-lab-plan-portal/select-lab-plans-service.png" alt-text="Screenshot that shows the Lab plan tile for Azure Marketplace.":::
 
 1. On the **Basics** tab of the **Create a lab plan** page:
     1. For the **Subscription**, select the Azure subscription in which you want to create the lab plan.
@@ -38,29 +39,32 @@ The following steps show how to use the Azure portal to create a lab plan.
     1. For **Region**, select the Azure region you want to create the lab plan.  (Region for the lab plan is also the default region where your labs will be created.)
     1. Select **Review + create**.
 
-    :::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-basics-tab.png" alt-text="Screenshot that shows the Basics tab of the Create a new lab plan experience.":::
+        :::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-basics-tab.png" alt-text="Screenshot that shows the Basics tab of the Create a new lab plan experience.":::
 
 1. Review the summary and select **Create**.
 
-:::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-review-create-tab.png" alt-text="Screenshot that shows the Review and Create tab of the Create a new lab plan experience.":::
+    :::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-review-create-tab.png" alt-text="Screenshot that shows the Review and Create tab of the Create a new lab plan experience.":::
 
 1. When the deployment is complete, expand **Next steps**, and select **Go to resource**.
 
-:::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-deployment-complete.png" alt-text="Screenshot that the deployment of the lab plan resource is complete.":::
+    :::image type="content" source="./media/quick-create-lab-plan-portal/Create-lab-plan-deployment-complete.png" alt-text="Screenshot that the deployment of the lab plan resource is complete.":::
 
 1. Confirm that you see the **Overview** page for *MyLabPlan*.
 
 ## Add a user to the Lab Creator role
+
 [!INCLUDE [Add Lab Creator role](./includes/lab-services-add-lab-creator.md)]
 
 ## Clean up resources
+
 When no longer needed, you can delete the resource group, lab plan, and all related resources.
 
 1. On the **Overview** page for the lab plan, select the **Resource group** link.
 1. At the top of the page for the resource group, select **Delete** resource group.
 1. A page will open warning you that you're about to delete resources. Type the name of the resource group and select **Delete** to finish deleting the resources and the resource group.
 
 ## Next steps
+
 In this quickstart, you created a resource group and a lab plan.  Advance to the next article to learn how to create a lab.
 > [!div class="nextstepaction"]
 > [Create a lab](quick-create-lab-portal.md)

articles/lab-services/media/quick-create-lab-portal/new-lab-window.png

@@ -22,30 +22,30 @@ The following steps show how to create a lab with Azure Lab Services.
 
 1. Sign into the [Azure Lab Service portal](https://labs.azure.com).
 1. Select **New lab**.  
-    
+
     :::image type="content" source="./media/quick-create-lab-portal/new-lab-button.png" alt-text="Screenshot of Azure Lab Services portal.  New lab button is highlighted.":::
 
 1. In the **New Lab** window, choose the basic settings for the lab.
     1. Set the **Name** to *Lab 101*.
     1. Set the **Virtual machine image** to **Windows 11 Pro**.
     1. Set the **Virtual machine size** to **Medium**. 
-    
-    :::image type="content" source="./media/quick-create-lab-portal/new-lab-window.png" alt-text="Screenshot of the New lab window for Azure Lab Services.":::
+
+        :::image type="content" source="./media/quick-create-lab-portal/new-lab-window.png" alt-text="Screenshot of the New lab window for Azure Lab Services.":::
 
     1. On the **Virtual machine credentials** page, specify default administrator credentials for all VMs in the lab. Specify the **name** and the **password** for the administrator.  By default all the student VMs will have the same password as the one specified here.
-   
-    :::image type="content" source="./media/quick-create-lab-portal/new-lab-credentials.png" alt-text="Screenshot of the Virtual Machine credentials window for Azure Lab Services.":::
+
+        :::image type="content" source="./media/quick-create-lab-portal/new-lab-credentials.png" alt-text="Screenshot of the Virtual Machine credentials window for Azure Lab Services.":::
 
     > [!IMPORTANT]
     > Make a note of user name and password. They won't be shown again.
 
     1. On the **Lab policies** page, leave the default selections and select **Next**.
 
-    :::image type="content" source="./media/quick-create-lab-portal/quota-for-each-user.png" alt-text="Screenshot of the Lab policy window when creating a new Azure Lab Services lab.":::
+        :::image type="content" source="./media/quick-create-lab-portal/quota-for-each-user.png" alt-text="Screenshot of the Lab policy window when creating a new Azure Lab Services lab.":::
 
     1. On the **Template virtual machine settings** window, leave the selection on **Create a template virtual machine**.
 
-    :::image type="content" source="./media/quick-create-lab-portal/template-virtual-machine-settings.png" alt-text="Screenshot of the Template virtual machine settings windows when creating a new Azure Lab Services lab.":::
+        :::image type="content" source="./media/quick-create-lab-portal/template-virtual-machine-settings.png" alt-text="Screenshot of the Template virtual machine settings windows when creating a new Azure Lab Services lab.":::
 
 1. You should see the following screen that shows the status of the template VM creation.
 
@@ -56,15 +56,18 @@ The following steps show how to create a lab with Azure Lab Services.
    :::image type="content" source="./media/quick-create-lab-portal/lab-template-page.png" alt-text="Screenshot of Template page of a lab.":::
 
 ## Clean up resources
+
 When no longer needed, you can delete the lab.  
 
 On the tile for the lab, select three dots (...) in the corner, and then select **Delete**.
 
-![Delete button](./media/how-to-manage-labs/delete-button.png)
+:::image type="content" source="./media/how-to-manage-labs/delete-button.png" alt-text="Screenshot of My labs page with More menu then Delete menu item highlighted.":::
 
 On the **Delete lab** dialog box, select **Delete** to continue with the deletion.
 
 ## Next steps
+
 In this quickstart, you created a lab with Azure Lab Services.  Advance to the next article to learn how to configure the template VM.
+
 > [!div class="nextstepaction"]
 > [Configure a template VM](how-to-create-manage-template.md)

articles/lab-services/media/tutorial-setup-lab/list-of-added-users.png

@@ -20,8 +20,8 @@ In this tutorial, you set up a lab with virtual machines that are used by studen
 
 ## Prerequisites
 
-- A lab plan.  To create a lab plan, see [Tutorial: Create a lab plan with Azure Lab Services](tutorial-setup-lab-plan.md).
-- Permission to create a lab.  Uou must be a member of one of these roles in the lab plan: Owner, Lab Creator, or Contributor.  For more information, see [Azure Lab Services built-in roles](administrator-guide.md#rbac-roles). The user account used to create a lab plan will already have the required permissions to create a lab.
+* A lab plan.  To create a lab plan, see [Tutorial: Create a lab plan with Azure Lab Services](tutorial-setup-lab-plan.md).
+* Permission to create a lab.  You must be a member of one of these roles in the lab plan: Owner, Lab Creator, or Contributor.  For more information, see [Azure Lab Services built-in roles](administrator-guide.md#rbac-roles). The user account used to create a lab plan will already have the required permissions to create a lab.
 
 Here's the typical workflow when using Azure Lab Services:
 
@@ -130,7 +130,6 @@ Create a scheduled event for the lab so that VMs in the lab are automatically st
 
 For more information about creating and managing schedules for a class, see [Create and manage schedule for labs](how-to-create-schedules.md).
 
-
 ## Add users to the lab
 
 In this section, you add students to the lab.  Students can be added to a lab several ways including [manually by entering an email address](how-to-configure-student-usage.md#add-users-by-email-address), [uploading a CSV file with student information](how-to-configure-student-usage.md#add-users-by-uploading-a-csv-file), or [syncing to an Azure AD group](how-to-configure-student-usage.md#sync-users-with-azure-ad-group).
@@ -153,7 +152,6 @@ By default, the **Restrict access** option, found on the **Users** page, is turn
     > [!NOTE]
     > After the students are registered with the lab, the list displays their names. The name that's shown in the list is constructed by using the first and last names of the student's information from Azure AD or their Microsoft Account.  For more information on supported account types, see [Student accounts](how-to-configure-student-usage.md#student-accounts).
 
-
 ## Send invitation emails to users
 
 1. Switch to the **Users** view if you aren't on the page already, and select **Invite all** on the toolbar.