Merge pull request #87772 from diberry/0908-luis-migrate

[Cogsvcs] LUIS - migration updates

Author: ktoliver

articles/cognitive-services/LUIS/luis-migration-authoring-steps.md

@@ -9,7 +9,7 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 09/02/2019
+ms.date: 09/08/2019
 ms.author: diberry
 ---
 
@@ -20,7 +20,7 @@ From the Language Understanding (LUIS) portal, migrate all the apps you own to u
 ## Prerequisites
 
 * **Optionally**, backup the apps from the LUIS portal's apps list by exporting each app or use the export [API](https://westus.dev.cognitive.microsoft.com/docs/services/5890b47c39e2bb17b84a55ff/operations/5890b47c39e2bb052c5b9c40).
-* **Optionally**, save each app's collaborator's list. This email list is provided as part of the migration process.
+* **Optionally**, save each app's collaborator's list. All collaborators can be sent an email as part of the migration process.
 * **Required**, you need to have an [Azure subscription](https://azure.microsoft.com/free/). A part of the subscription process does require billing information. However, you can use Free (F0) pricing tiers when you use LUIS. You may eventually find you need a paid tier, as your usage increases. 
 
 If you do not have an Azure subscription, [sign up](https://azure.microsoft.com/free/). 
@@ -33,20 +33,35 @@ On a weekly basis, you are prompted to migrate your apps. You can cancel this wi
 
 The migration process is available if you are the owner of any LUIS apps. 
 
-1. 1. Sign in to [LUIS portal](https://www.luis.ai) and agree to the terms of use.
+1. Sign in to [LUIS portal](https://www.luis.ai) and agree to the terms of use.
 1. The migration pop-up window allows you to continue the migration or migrate later. Select **Migrate now**. If you choose to migrate later, you have 9 months to migrate to the new authoring key in Azure.
 
     ![First pop-up window in migration process, select Migrate now.](./media/migrate-authoring-key/migrate-now.png)
 
-1. If any of your apps have collaborators, you are prompted to **send them an email** letting them know about the migration. This is an optional step. The default email application opens with a lightly formatted email. 
+1. Optionally, if any of your apps have collaborators, you are prompted to **send them an email** letting them know about the migration. This is an optional step. 
 
-    ![Send collaborators email about migration](./media/migrate-authoring-key/send-collaborators-email.png)
+    Once you have migrated your account to Azure, your apps will no longer be available to collaborators.
+
+    For each collaborator and app, the default email application opens with a lightly formatted email. You can edit the email before sending it.
+
+    The email template includes the exact app Id and app name. 
+
+    ```html
+    Dear Sir/Madam,
+    
+    I will be migrating my LUIS account to Azure. Consequently, you will no longer have access to the following app:
+    
+    App Id: <app-ID-omitted>
+    App name: Human Resources
+    
+    Thank you
+    ```
 
 1. Choose to create a LUIS authoring resource by selecting **Start by creating an authoring resource to migrate your apps to**. 
 
     ![Create authoring resource](./media/migrate-authoring-key/choose-authoring-resource.png)
 
-1. In the next window, enter your resource key information. After you enter the information, select **Create resource**. 
+1. In the next window, enter your resource key information. After you enter the information, select **Create resource**. You can have 10 free authoring resources per region, per subscription.
 
     ![Create authoring resource](./media/migrate-authoring-key/choose-authoring-resource-form.png)
 
@@ -59,6 +74,10 @@ The migration process is available if you are the owner of any LUIS apps.
     * **Location** - the location choice is based on the **resource group** selection.
     * **Pricing tier** - the pricing tier determines the maximum transaction per second and month. 
 
+1. Validate your authoring resource and **Migrate now**.
+
+    ![Create authoring resource](./media/migrate-authoring-key/choose-authoring-resource-and-migrate.png)
+
 1. When the authoring resource is created, the success message is shown. Select **Close** to close the pop-up window.
 
     ![Your authoring resource was successfully created.](./media/migrate-authoring-key/migration-success.png)
@@ -67,6 +86,10 @@ The migration process is available if you are the owner of any LUIS apps.
 
     You don't need to know the authoring resource's key to continue editing your apps in the LUIS portal. If you plan to edit your apps programmatically, you need the authoring key values. These values are displayed on the **Manage -> Azure resources** page in the LUIS portal and are also available in the Azure portal on the resource's **Keys** page.  
 
+1. Before accessing your apps, select the subscription and LUIS authoring resource to see the apps your can author.
+
+    ![Select subscription and LUIS authoring resource to see the apps your can author.](./media/migrate-authoring-key/app-list-by-subscription-and-resource.png)
+
 ## After the migration process, add contributors to your authoring resource
 
 [!INCLUDE [Manage contributors for the Azure authoring resource for language understanding](./includes/manage-contributors-authoring-resource.md)]

articles/cognitive-services/LUIS/luis-migration-authoring.md

@@ -9,7 +9,7 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 09/06/2019
+ms.date: 09/08/2019
 ms.author: diberry
 ---
 
@@ -86,7 +86,7 @@ You may choose to export an app you are a collaborator on, then import the app b
 
 ### After the app is migrated
 
-After the migration process, you need to be added to the Azure authoring resource by the app owner.  
+After the migration process, if you need access to the original app, you need to be added to the Azure authoring resource as a collaborator by the app owner.  
 
 ## Next steps