Update for readability after team review

Author: ntrogh

articles/lab-services/how-to-configure-canvas-for-lab-plans.md

@@ -10,7 +10,7 @@ ms.custom: engagement-fy23
 
 # Configure Canvas to use Azure Lab Services
 
-In this article, you learn how to add the Azure Lab Services app to [Canvas](https://www.instructure.com/canvas). The Azure Lab Services app lets educators and students access to their labs directly from Canvas without navigating to the Azure Lab Services portal. Learn more about the [benefits of using Azure Lab Services within Canvas](./lab-services-within-canvas-overview.md).
+In this article, you learn how to add the Azure Lab Services app to [Canvas](https://www.instructure.com/canvas). Educators and students can use the Azure Lab Services app to access their labs directly from Canvas, without having to navigate to the Azure Lab Services web portal. Learn more about the [benefits of using Azure Lab Services within Canvas](./lab-services-within-canvas-overview.md).
 
 For information about creating and managing labs in Canvas, see [Create and manage labs in Canvas](./how-to-manage-labs-within-canvas.md).
 
@@ -19,38 +19,54 @@ For information about creating and managing labs in Canvas, see [Create and mana
 ## Prerequisites
 
 - An Azure Lab Services lab plan. Follow these steps to [Create a lab plan in the Azure portal](./tutorial-setup-lab-plan.md), if you don't have one yet.
-- To add the Azure Lab Services app, your Canvas user account needs Canvas administrator permissions.
-- To link lab plans, your account needs: 
-    - Canvas administrator permissions.
+
+- Your Canvas account needs [Admin permissions](https://community.canvaslms.com/t5/Canvas-Basics-Guide/What-is-the-Admin-role/ta-p/78) to add the Azure Lab Services app to Canvas, and to link lab plans.
+
+- To link lab plans, your Azure account needs the following permissions. Learn how to [assign Azure Active Directory roles to users](/azure/active-directory/roles/manage-roles-portal).
     - Reader role on the Azure subscription.
     - Contributor role on the resource group that contains your lab plan.
     - Write access to the lab plan.
 
 ## Enable the Azure Lab Services app in Canvas
 
-You can use Canvas for accessing Azure Lab Services by enabling the Azure Lab Services Canvas app. The Azure Lab Services app is an inherited app in Canvas. To use the app, enable the corresponding developer key:
+The first step to let users access their labs and lab plans through Canvas is to enable the Azure Lab Services app in Canvas. To use a third-party application, such as Azure Lab Services, in Canvas, you have to enable the corresponding developer key in Canvas.
+
+The Canvas developer key for the Azure Lab Services app is an *inherited key*, also referred to as a *global developer key*. Learn more about [developer keys in the Canvas Community Hub](https://community.canvaslms.com/t5/Canvas-Admin-Blog/Administrative-guidelines-for-managing-Inherited-Developer-Keys/ba-p/269029).
+
+To enable the Azure Lab Services app, your Canvas account needs Canvas administrator permissions.
+
+To enable the developer key for the Azure Lab Services app:
 
 1. In Canvas, select the **Admin** page.
+
 1. Select **Developer Keys** in the left navigation.
+
 1. Select the **Inherited** tab of the developer keys.
+
 1. In the list, change the state of the **Azure Lab Services** entry to **On**.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-enable-lab-services-app.png" alt-text="Screenshot that shows how to turn on the inherited Azure Lab Services app in the Canvas Admin settings.":::
 
 ## Add Azure Lab Services app to an account (optional)
 
-After enabling the Azure Lab Services app in Canvas, you might enable the Azure Lab Services app for the entire account. Enabling the app at the account level lets educators quickly enable or disable navigation to Azure Lab Services on a per-course basis.
+You can enable the Azure Lab Services app for a Canvas course in either of two ways:
+
+- Add the Azure Lab Services app at the Canvas account level. 
 
-If you want to add the app to a specific course, skip to [Add the Azure Lab Services app to a course](#add-the-azure-lab-services-app-to-a-course).
+- [Add the Azure Lab Services app for a specific course](#add-the-azure-lab-services-app-to-a-course) in Canvas.
 
-To add the app at the account level:
+When you add the app at the Canvas account level, you avoid that you have to add the app for every individual course. If you have multiple courses that use Azure Lab Services, adding the app at the account level might be quicker. After adding the app for the Canvas account, you only have to [enable the Azure Lab Services app in the course navigation](#enable-azure-lab-services-in-course-navigation).
+
+To add the app at the Canvas account level:
 
 1. In Canvas, select the **Admin** menu.
-1. Select the account that you want to add the Azure Lab Services app to. Alternatively, select **All Accounts** to add the Azure Lab Services app to all accounts for the Canvas LMS instance.
+
+1. Select the account that you want to add the Azure Lab Services app to. Alternatively, select **All Accounts** to add the Azure Lab Services app to all accounts for the Canvas Learning Management System (LMS) instance.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-admin-choose-account.png" alt-text="Screenshot that shows the Admin menu and accounts list in Canvas.":::
 
-1. Choose **Settings**, then select the **Apps** tab.
+1. Choose **Settings**, and then select the **Apps** tab.
+
 1. Select **View App Configurations** button at the top right of the page.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-admin-settings.png" alt-text="Screenshot that shows the App tab of the admin settings page in Canvas.":::
@@ -65,20 +81,24 @@ To add the app at the account level:
 
 1. When the **Add App** dialog asks *Tool "Azure Lab Services" found for client ID 170000000000711. Would you like to install it?*, select **Install**.
 
-The Azure Lab Services app is now available for all courses in that account. The app doesn't show up in the course navigation by default. Move to the next step to [enable the app in course navigation](#enable-azure-lab-services-in-course-navigation).
+The Azure Lab Services app is now available for all courses in that account.
 
 ## Add Azure Lab Services to a course
 
-To use Azure Lab Services in a course, you now add the Azure Lab Services app to a course. 
+Next, you associate the Azure Lab Services app with a course in Canvas. You have two options to configure a course in Canvas to use Azure Lab Services:
+
+- If you added the Azure Lab Services app at the Canvas account level, [enable the app in the course navigation](#enable-azure-lab-services-in-course-navigation).
 
-If you previously added the app at the account level, you only need to enable the app in the course navigation. Skip to [enable the app in the course navigation](#enable-azure-lab-services-in-course-navigation).
+- Otherwise, [add the Azure Lab Services app to a course](#add-the-azure-lab-services-app-to-a-course).
 
 ### Add the Azure Lab Services app to a course
 
-To add the app at the course level:
+You add the Azure Lab Services app to a specific course in Canvas, if you didn't previously add the Azure Lab Services app at the Canvas account level.
 
 1. In Canvas, go to the course that uses Azure Lab Services.
+
 1. Choose **Settings**, and then select the **Apps** tab.
+
 1. Select **View App Configurations** button at the top right of the page.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-settings-apps.png" alt-text="Screenshot that shows the App tab of the settings page for a course in Canvas.":::
@@ -95,36 +115,39 @@ To add the app at the course level:
 
     The Azure Lab Services app takes a few moments to show in the course navigation list.
 
-You can now move to [Link a lab plan to a course](#link-lab-plans-to-canvas) to finalize the configuration of Canvas.
+You can skip to [Link a lab plan to a course](#link-lab-plans-to-canvas) to finalize the configuration of Canvas.
 
 ### Enable Azure Lab Services in course navigation
 
-If you added the app at the account level, you should enable the app in the course navigation to use Azure Lab Services in course:
+If you previously added the app at the Canvas account level, you don't have to add the app for a specific course. Instead, you enable the app in the Canvas course navigation:
 
 1. In Canvas, go to the course that uses Azure Lab Services.
+
 1. Choose **Settings**, then select the **Navigation** tab.
-1. Find the **Azure Lab Services** entry, select the three vertical dots, then select **Enable**.
+
+1. Find the **Azure Lab Services** entry, select the three vertical dots, and then select **Enable**.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-enable-lab-services-app-in-course-navigation.png" alt-text="Screenshot of enabling Lab Services app in course navigation.":::
 
 1. Select **Save**.
 
-You can now move to [Link a lab plan to a course](#link-lab-plans-to-canvas) to finalize the configuration of Canvas.
-
 ## Link lab plans to Canvas
 
-After enabling the Azure Lab Services app in Canvas, you can link lab plans to Canvas. Only linked lab plans are available for Canvas educators to use when creating labs.
+After you enable the Azure Lab Services app in Canvas and associate it with a course, you link specific lab plans to Canvas. You can only use linked lab plans for creating labs in Canvas.
 
-To link lab plans to Canvas, your account must be a Canvas administrator. The Canvas administrator must have the following permissions on the lab plan.
+To link lab plans to Canvas, your Canvas account must be a Canvas administrator. In addition, your Azure account must have the following permissions on the lab plan.
 
 - Reader role on the subscription.
 - Contributor role on the resource group that contains your lab plan.
 
 Perform the following steps to link lab plans to Canvas:
 
 1. In Canvas, go to a course for which you previously added the Azure Lab Services app.
+
 1. Open the Azure Lab Services app in the course.
+
 1. Select the tool icon in the upper right to see the list all the lab plans.
+
 1. Choose the lab plans you want to link to Canvas from the list.
 
     :::image type="content" source="./media/how-to-configure-canvas-for-lab-plans/canvas-select-lab-plans.png" alt-text="Screenshot that shows the list of lab plans that can be linked to Canvas.":::

articles/lab-services/includes/lab-services-new-update-focused-article.md

@@ -7,4 +7,4 @@ ms.custom: devdivchpfy22
 ---
 
 > [!NOTE]
-> This article references features available since the August 2022 Update, in which [lab plans](../how-to-manage-lab-plans.md) replaced lab accounts. For more information, see [What's New in the August 2022 Update](../lab-services-whats-new.md).
+> This article references features available since the August 2022 Update, when [lab plans](../how-to-manage-lab-plans.md) replaced lab accounts. For more information, see [What's New in the August 2022 Update](../lab-services-whats-new.md).