review of teams articles

Author: EMaher

articles/lab-services/TOC.yml

@@ -129,8 +129,26 @@
       href: how-to-configure-firewall-settings.md
     - name: Specify Marketplace images for labs 
       href: specify-marketplace-images.md
-    - name: Specify support information (lab account owner)
+    - name: Specify support information (lab plan owner)
       href: lab-account-owner-support-information.md
+  - name: Create and configure lab accounts (deprecated)
+    items:
+    - name: Create and manage labs
+      href: how-to-manage-classroom-labs.md        
+    - name: Create and manage lab accounts
+      href: how-to-manage-lab-accounts.md
+    - name: Manage labs in a lab account
+      href: manage-labs-1.md
+    - name: Configure auto-shutdown of VMs for a lab account
+      href: how-to-configure-lab-accounts.md
+    - name: Allow lab creator to pick lab location
+      href: allow-lab-creator-pick-lab-location.md
+    - name: Connect to a peer virtual network 
+      href: how-to-connect-peer-virtual-network.md
+    - name: Attach or detach a shared image gallery
+      href: how-to-attach-detach-shared-image-gallery-1.md
+    - name: Add additional owners to a lab
+      href: how-to-add-user-lab-owner.md
   - name: Create and configure labs (educator)
     items:        
     - name: Create and manage labs
@@ -171,26 +189,6 @@
       href: lab-creator-support-information.md
     - name: Access student VMs from educator view
       href: instructor-access-virtual-machines.md
-    - name: (deprecated)
-      items:
-      - name: Create and manage labs (deprecated)
-        href: how-to-manage-classroom-labs.md        
-      - name: Create and configure lab accounts (deprecated)
-        items:
-        - name: Create and manage lab accounts
-          href: how-to-manage-lab-accounts.md
-        - name: Manage labs in a lab account
-          href: manage-labs-1.md
-        - name: Configure auto-shutdown of VMs for a lab account
-          href: how-to-configure-lab-accounts.md
-        - name: Allow lab creator to pick lab location
-          href: allow-lab-creator-pick-lab-location.md
-        - name: Connect to a peer virtual network 
-          href: how-to-connect-peer-virtual-network.md
-        - name: Attach or detach a shared image gallery
-          href: how-to-attach-detach-shared-image-gallery-1.md
-        - name: Add additional owners to a lab
-          href: how-to-add-user-lab-owner.md
   - name: Connect to VMs in labs (student)
     items:        
     - name: Access labs

articles/lab-services/how-to-access-vm-for-students-within-teams.md

@@ -2,24 +2,22 @@
 title:  Access a VM (student view) in Azure Lab from Teams
 description: Learn how to access a VM (student view) in Azure Lab from Teams. 
 ms.topic: how-to
-ms.date: 10/07/2020
+ms.date: 01/06/2022
 ---
 
 # Access a VM (student view) in Azure Lab from Teams
 
 When a lab is created within Teams, users can view and access all the VMs provisioned by the team owner. Once the lab is published and VMs are created, users will be automatically registered to the lab and assigned a VM on their first login to Azure Lab Services. Users can view and access the VM's assigned to them by selecting the tab containing **Azure Lab Services** app.
 
+> [!div class="mx-imgBorder"]
+> :::image type="content" source="./media/how-to-access-vm-for-students-within-teams/published-lab.png" alt-text="Not published Azure Lab Services lab":::
+
 If the lab is yet to be published or a sync is yet to be triggered after they are added to the team, similar messaging will be shown to the students.
 
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/how-to-access-vm-for-students-within-teams/not-published-lab.png" alt-text="Not published Azure Lab Services lab":::
 
 ## Next steps
 
-For more information, see the following articles:
-
-- [Use Azure Lab Services within Teams overview](lab-services-within-teams-overview.md)
-- [Get started and create a lab within Teams](how-to-get-started-create-lab-within-teams.md)
-- [Manage lab user lists within Teams](how-to-manage-user-lists-within-teams.md)
-- [Manage lab's VM pool within Teams](how-to-manage-vm-pool-within-teams.md)
-- [Create and manage lab schedules within Teams](how-to-create-schedules-within-teams.md)
+- [Start the VM](tutorial-connect-lab-virtual-machine.md#start-the-vm)
+- [Connect to the VM](tutorial-connect-lab-virtual-machine.md#connect-to-the-vm)

articles/lab-services/how-to-create-schedules-within-teams.md

@@ -2,33 +2,33 @@
 title: Create Azure Lab Services schedules within Teams
 description: Learn how to create Lab Services schedules within Teams. 
 ms.topic: how-to
-ms.date: 10/07/2020
+ms.date: 01/06/2022
 ---
 
 # Create and manage Lab Services schedules within Teams
 
-Schedules allow you to configure a lab such that VMs in the lab automatically start and shut down at a specified time. You can define a one-time schedule or a recurring schedule. The following procedures give you steps to create and manage schedules for a lab:
+Schedules allow you to configure a lab such that VMs in the lab automatically start and shut down at a specified time. You can define a one-time schedule or a recurring schedule. The article covers the procedures to create and manage schedules for a lab.
 
 Here's how schedules affect lab virtual machines:
 
-- Template virtual machine is not included in schedules.
-- Only assigned virtual machines are started. This means, if a machine is not claimed by an end user (student), the machine will not start on the scheduled hours.
+- Template virtual machine isn't included in schedules.
+- Only assigned virtual machines are started. If a machine is not claimed by user (student), the machine won't start on the scheduled hours.
 - All virtual machines (whether claimed by a user or not) are stopped based on the lab schedule.
 
 > [!IMPORTANT]
 > The scheduled running time of VMs does not count against the quota allotted to a user. The quota is for the time outside of schedule hours that a student spends on VMs.
 
-Users can create, edit, and delete lab schedules within Teams just as in the [labs website](https://labs.azure.com). Refer to the article on [creating and managing schedules](how-to-create-schedules-within-teams.md).
+Users can create, edit, and delete lab schedules within Teams as in the [Azure Lab Services portal](https://labs.azure.com). For more information, see [creating and managing schedules](how-to-create-schedules-within-teams.md).
 
 ## Automatic shutdown and disconnect settings
 
-You can enable several autoshutdown cost control features to proactively prevent additional costs when the virtual machines are not being actively used. The combination of the following three automatic shutdown and disconnect features catches most of the cases where users accidentally leave their virtual machines running:
+You can enable several automatic shutdown cost control features to prevent extra costs when the VMs aren't being actively used. The combination of the following three automatic shutdown and disconnect features catches most of the cases where users accidentally leave their virtual machines running:
 
-- Automatically disconnect users from virtual machines that the OS deems idle.
+- Automatically disconnect users from virtual machines that the OS considers idle.
 - Automatically shut down virtual machines when users disconnect.
 - Automatically shut down virtual machines that are started but users don't connect.
 
-For more details, refer to the article on [configuring auto-shutdown settings for a lab](how-to-enable-shutdown-disconnect.md).
+For more information, see the article on [configuring auto-shutdown settings for a lab](how-to-enable-shutdown-disconnect.md).
 
 ## Next steps
 

articles/lab-services/how-to-delete-lab-within-teams.md

@@ -2,28 +2,30 @@
 title: Delete an Azure Lab Services lab from Teams
 description: Learn how to delete an Azure Lab Services lab from Teams. 
 ms.topic: how-to
-ms.date: 10/12/2020
+ms.date: 01/06/2022
 ---
 
 # Delete labs within Teams
 
 This article shows how to delete a lab from the **Azure Lab Services** app.
 
+[!INCLUDE [preview note](./includes/lab-services-new-update-focused-article.md)]
+
 ## Prerequisites
 
-* [Create a Lab Services account](tutorial-setup-lab-account.md#create-a-lab-account) in the Azure portal.
-* [Get started and create a Lab Services lab within Teams](how-to-get-started-create-lab-within-teams.md).
+* [Create a lab plan](tutorial-setup-lab-plan.md).
+* [Create a lab within Teams](how-to-get-started-create-lab-within-teams.md).
 
 ## Delete labs
 
-A lab created within Teams can be deleted in the [Lab Services website](https://labs.azure.com) by deleting the lab directly, as described in [Manage labs in Azure Lab Services](how-to-manage-labs.md).
+A lab created within Teams can be deleted in the [Lab Services portal](https://labs.azure.com) directly.  For more information, see [Delete a lab](manage-labs.md#delete-a-lab).
 
-Lab deletion is also triggered when the team is deleted. If the team in which the lab is created gets deleted, lab would be automatically deleted 24 hours after the automatic user list sync is triggered.
+Lab deletion is also triggered when the team is deleted. If the associated team is deleted, the lab will be automatically deleted 24 hours later when the automatic user list sync is triggered.
 
 > [!IMPORTANT]
 > Deletion of the tab or uninstalling the app will not result in deletion of the lab.
 
-If the tab is deleted, users on the team membership list will still be able to access the VMs on the [Lab Services website](https://labs.azure.com) unless the lab deletion is explicitly triggered by deleting the lab on website or deleting the team.
+If the *tab* is deleted in Teams, users can still access the lab VMs on the [Azure Lab Services portal](https://labs.azure.com).  When the team is deleted or the lab is explicitly deleted, users can no longer access their VMs through the [Azure Lab Services portal](https://labs.azure.com).
 
 ## Next steps
 

articles/lab-services/how-to-get-started-create-lab-within-teams.md

@@ -2,61 +2,59 @@
 title: Get started and create an Azure Lab Services lab within Teams
 description: Learn how to get started and create an Azure Lab Services lab within Teams. 
 ms.topic: how-to
-ms.date: 10/08/2020
+ms.date: 01/06/2022
 ---
 
 # Get started and create a Lab Services lab within Teams
 
 This article shows how to add the **Azure Lab Services** app to a Team and then how to create a lab within MS Teams environment.
 
+[!INCLUDE [preview note](./includes/lab-services-new-update-focused-article.md)]
+
 ## Prerequisites
 
-In this tutorial you set up a lab with virtual machines for your team. To set up a lab in a lab account, you must be a member of one of these roles in the lab account: Owner, Lab Creator, or Contributor. The account you used to create a lab account is automatically added to the owner role. So, you can use the user account that you used to create a lab account to create a lab.
+In this tutorial, you set up a lab with virtual machines for your team. To set up a lab, you must be an Owner, Lab Creator, or Contributor on the lab plan. The user account that you used to create a lab plan can create a lab.
 
-Here is the typical workflow when using Azure Lab Services within Teams
+Here's the typical workflow when using Azure Lab Services within Teams
 
-1. User [creates a Lab Account](tutorial-setup-lab-account.md#create-a-lab-account) on the Azure portal.
-1. A [lab account creator adds other users](tutorial-setup-lab-account.md#add-a-user-to-the-lab-creator-role) to the **Lab Creator** role. For example, the lab account creator/admin adds educators to the **Lab Creator** role so that they can create labs for their classes.
-1. Then, the educators create labs, pre-configures the template VM and publishes the lab to provision VM's to everyone on the team.
-1. Once the lab is published, a VM is assigned to everyone on the team membership list on their first login to Azure Lab Services, either by clicking on the tab containing **Azure Lab Services** App within Teams(SSO) or by accessing the [labs website](https://labs.azure.com). Users can then use the VM to do the class work and homework.
+1. Create a lab plan in the Azure portal.  For information, see [Tutorial: Set up a lab plan with Azure Lab Services](tutorial-setup-lab-plan.md).
+1. The lab plan owner [adds educators to the Lab Creator role](tutorial-setup-lab-plan.md#add-a-user-to-the-lab-creator-role) so they can create labs for their classes.
+1. Then, the educators create labs, pre-configures the template VM and publishes the lab to create VMs to everyone on the team.
+1. Once the lab is published, a VM is assigned to everyone on the team membership list on their first sign into Azure Lab Services. Team members select on the tab containing **Azure Lab Services** App within Teams or by accessing the [Azure Lab Services portal](https://labs.azure.com). Team members can then use the VM to do the class work and homework.
 
 > [!IMPORTANT]
-> Azure Lab Services can be used within Teams only if the lab accounts are created in the same tenant as Teams.
+> Azure Lab Services can be used within Teams only if the lab plans are created in the same tenant as Teams.
 
 ## Add Azure Lab Services app as a tab to a Team
 
 You, as a Team owner, can add **Azure Lab Services** app directly in your Teams channels, and then the app is available for everyone in the team to use. Follow the below three steps:
 
-1. Navigate to the Teams channel where you want to add the app and select **+** to add a tab. 
-1. Search for **Azure Lab Services** from the tab options and add this app. 
+1. Navigate to the Teams channel where you want to add the app and select **+** to add a tab.
+1. Search for **Azure Lab Services** from the tab options and add this app.
 
     > [!NOTE]
     > Only Team **Owners** will be able to create labs for the team.
 
     > [!div class="mx-imgBorder"]
     > :::image type="content" source="./media/integrate-with-teams/add.png" alt-text="Add a tab":::
-1. Select a Lab Services account, which you would like to use for creating labs in this team.
-
-    Azure Lab Services uses single sign-on into the [Azure Lab Services website](https://labs.azure.com) and pulls all the lab accounts that you have access to. 
+1. Select a resource group, containing one or more lab plans, that you would like to use for creating labs in this team.
 
-    The accounts that are in the same tenant as Teams and for which you have **Owner**, **Contributor**, or **Creator** access are displayed. 
+    Azure Lab Services uses single sign-on into the [Azure Lab Services portal](https://labs.azure.com) and pulls all the lab plans that you have access to.  The resource groups with lab plans that are in the same tenant as Teams and for which you have **Owner**, **Contributor**, or **Creator** access are displayed.
 
     > [!div class="mx-imgBorder"]
     > :::image type="content" source="./media/integrate-with-teams/welcome.png" alt-text="Welcome to ALS":::
-1. Press **Save** and the tab gets added to the channel.
+1. Press **Save**. The Azure Lab Services tab is added to the channel.
 
     > [!div class="mx-imgBorder"]
     > :::image type="content" source="./media/integrate-with-teams/created.png" alt-text="Created the ALS tab":::
 
     Now you can select the **Azure Lab Services** tab from your channel and start managing labs as described in the following articles.
 
-After the lab account is selected, Team owners will be able to create labs for the team. The entire lab creation process and all the tasks at the lab level can be performed within Teams. Users will have the option to create multiple labs within the same team and the Team owner, with appropriate access at the lab account level, will see only the labs associated with the specific team.
+After the lab plan is selected, Team owners can create labs for the team. The entire lab creation process and all the tasks at the lab level can be performed within Teams. Educators can create multiple labs within the same team and the Team owner, with appropriate access at the lab plan level, will see only the labs associated with the specific team.
 
 ## Next steps
 
-When a lab is created within Teams, the lab user list is automatically populated and synced with the team membership. Everyone on the team, including Owners, Members and Guests will be automatically added to the lab user list. Azure lab Services will maintain a sync with the team membership and an automatic sync is triggered every 24 hours. For details, see:
-
-[Manage Lab Services user lists within Teams](how-to-manage-user-lists-within-teams.md)
+When a lab is created within Teams, the lab user list is automatically populated and synced with the team membership. Everyone on the team, including owners, members, and guests will be automatically added to the lab user list. Azure lab Services will maintain a sync with the team membership.  An automatic sync is triggered every 24 hours. For more information, see [Manage Lab Services user lists within Teams](how-to-manage-user-lists-within-teams.md)
 
 ### See also
 

articles/lab-services/how-to-manage-user-lists-within-teams.md

@@ -2,42 +2,33 @@
 title: Manage Azure Lab Services user lists from Teams
 description: Learn how to manage Azure Lab Services user lists from Teams. 
 ms.topic: how-to
-ms.date: 10/07/2020
+ms.date: 01/04/2022
 ---
 
 # Manage Lab Services user lists from Teams
 
-When a lab is created within Teams (see [Get started and create a Lab Services lab from Teams](how-to-get-started-create-lab-within-teams.md)), the lab user list is automatically populated and synced with the team membership. Everyone on the team, including Owners, Members, and Guests will be automatically added to the lab user list. Azure lab Services maintains a sync with the team membership and an automatic sync is triggered every 24 hours. 
+When a lab is [created within Teams](how-to-get-started-create-lab-within-teams.md)), the lab user list is automatically populated and synced with the team membership. Everyone on the team, including owners, members, and guests will be automatically added to the lab user list. Azure lab Services maintains a sync with the team membership and an automatic sync is triggered every 24 hours.
 
 ## Sync users
 
-Educators can use the **Sync** button to trigger a manual sync once the team membership is updated. 
+Educators can use the **Sync** button to trigger a manual sync once the team membership is updated.
 
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/how-to-manage-users-with-teams/sync-users.png" alt-text="Sync users":::
 
-Once the automatic or manual sync is complete the following is true depending on whether the lab has been published.
+Users will be added or deleted from the lab user list as per changes to the team membership when the sync operation has completed.  
+
+If the lab has been published, the lab capacity will be automatically updated.
 
-* If the lab has not been published at least once:
-    * Users will be added or deleted from the lab user list as per changes to the team membership. 
-* If the lab has been published at least once, in addition to adding or deleting users, the lab capacity will be automatically updated.
     * If there are any new additions to the team, new VMs will be created.
     * If any user has been deleted from the team, the associated VM will be deleted as well.
 
 ## Next steps
 
-Once the template VM is configured and when the educator selects to publish the template, number of VMs equivalent to the number of users in the lab’s user list will be created. Once the lab is published and VMs are created, Users will be automatically registered to the lab and VMs will be assigned to them on their first login to Azure Lab Services that is, when they first access the tab having **Azure Lab Services** App. 
-
 To publish the template VM, go to the Teams Lab Services window, select **Template** tab -> **...** -> **Publish**.
 
-To manage VM pools, see [Manage a VM pool in Lab Services from Teams](how-to-manage-vm-pool-within-teams.md).
-
-### Also review
+Also review:
 
-See the following articles:
-
-- [Use Azure Lab Services within Teams overview](lab-services-within-teams-overview.md)
-- [Get started and create a Lab Services lab from Teams](how-to-get-started-create-lab-within-teams.md)
+- [Manage a VM pool in Lab Services from Teams](how-to-manage-vm-pool-within-teams.md).
 - [Create Lab Services schedules from Teams](how-to-create-schedules-within-teams.md)
 - [Access a VM (student view) in Lab Services from Teams](how-to-access-vm-for-students-within-teams.md)
-

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

@@ -7,17 +7,17 @@ ms.date: 10/07/2020
 
 # Manage a VM pool in Lab Services from Teams
 
-Virtual Machine (VM) creation starts as soon as the template VM is first published. VMs equaling the number of users in the lab user list will be created. VMs are automatically assigned to students upon their first login to Azure Lab Services. 
+Virtual Machine (VM) creation starts as soon as the template VM is first published. VMs equaling the number of users in the lab user list will be created. VMs are automatically assigned to students when they first access the Azure Lab Services lab.
 
 ## Publish a template and manage a VM pool
 
 To publish the template, go to the Teams Lab Services window, select **Template** tab -> **...** -> **Publish**.
 
-Once the template VM is configured and when the educator selects to publish the template, number of VMs equivalent to the number of users in the lab’s user list will be created. Once the lab is published and VMs are created, Users will be automatically registered to the lab and VMs will be assigned to them on their first login to Azure Lab Services that is, when they first access the tab having **Azure Lab Services** App. 
+Once the lab is published and VMs are created, users will be automatically registered to the lab. Lab VMs will be assigned to users the first time they first access the tab having **Azure Lab Services** App.
 
-When a user list sync is triggered, Lab Capacity (number of VMs in the lab) will be automatically updated based on the changes to the team membership. New VMs will be created as new users are added and VMs assigned to the users removed from the team will be deleted as well. For more information see [How to manage users within Teams](how-to-manage-user-lists-within-teams.md). 
+Team membership and lab user list are kept in sync.  The lab capacity (number of VMs in the lab) will be automatically updated based on the changes to the team membership. New VMs will be created as new users are added to the team.  VMs assigned to the users removed from the team will be deleted. For more information, see [How to manage users within Teams](how-to-manage-user-lists-within-teams.md).
 
-Educators can continue to access student VMs directly from the VM Pool tab. And educators can access VMs assigned to themselves either from the **Virtual machine pool** tab or by clicking on the **My Virtual Machines** button (top/right corner of the screen). 
+Educators can continue to access student VMs directly from the VM Pool tab. And educators can access VMs assigned to themselves either from the **Virtual machine pool** tab or by clicking on the **My Virtual Machines** button (top-right corner of the screen).
 
 > [!div class="mx-imgBorder"]
 > :::image type="content" source="./media/how-to-manage-vm-pool-with-teams/vm-pool.png" alt-text="VM pool":::
@@ -32,4 +32,3 @@ See the following articles:
 - [Create Lab Services schedules from Teams](how-to-create-schedules-within-teams.md)
 - [Access a VM (student view) in Lab Services from Teams](how-to-access-vm-for-students-within-teams.md)
 
-