Merge pull request #108982 from diberry/diberry/0325-luis-fresh-1

[Cogsvcs] LUIS - Fresh - 2

Author: garycentric

articles/cognitive-services/LUIS/includes/howto-publish.md

@@ -15,15 +15,16 @@ ms.author: diberry
 
 In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the endpoint.
 
-1. Select **Publish** in the top right navigation.
+1. Select **Publish** in the top-right navigation.
 
     ![LUIS publish to endpoint button in top right menu](../media/howto-publish/publish-button.png)
 
-2. Select the **Production** slot and the **Publish** button.
+2. Select the **Production** slot, then select **Done**.
 
-    ![LUIS publish to endpoint](../media/howto-publish/publish-app-popup.png)
+    > [!div class="mx-imgBorder"]
+    > ![LUIS publish to endpoint](../media/howto-publish/publish-app-popup.png)
 
-3. Publishing is complete when you see the status bar at the top of the page confirming success.
+3. Publishing is complete when you see the notification confirming success.
 
     ![LUIS publish to endpoint](../media/howto-publish/publish-endpoint-success.png)
 

articles/cognitive-services/LUIS/includes/select-authoring-resource.md

@@ -1,17 +1,12 @@
 ---
 title: Select authoring resource
-titleSuffix: Azure Cognitive Services
-services: cognitive-services
-author: diberry
-manager: nitinme
-ms.service: cognitive-services
-ms.topic: include 
-ms.date: 11/04/2019
-ms.author: diberry
+ms.topic: include
+ms.date: 03/25/2020
 ---
 
 ## Select subscription and authoring resource
 
-In the LUIS portal, to see a list of apps or to create an app, select the subscription and authoring resource. Apps are accessed by the LUIS authoring resource. 
+In the LUIS portal, to see a list of apps or to create an app, select the subscription and authoring resource. Apps are accessed by the LUIS authoring resource.
 
-![Select authoring subscription and authoring resource](../media/select-authoring-resource/select-authoring-resource.png)
+> [!div class="mx-imgBorder"]
+> ![Select authoring subscription and authoring resource](../media/select-authoring-resource/select-authoring-resource.png)

articles/cognitive-services/LUIS/includes/v3-prediction-endpoint.md

@@ -5,17 +5,17 @@ services: cognitive-services
 author: diberry
 manager: nitinme
 ms.service: cognitive-services
-ms.topic: include 
+ms.topic: include
 ms.date: 10/14/2019
 ms.author: diberry
 ---
 
 
-1. In the LUIS portal, in the Manage section (top right menu), on the Keys and endpoints page (left menu), select the endpoint URL at the bottom of the page.
+1. In the LUIS portal, in the **Manage** section (top right menu), on the **Azure Resources** page (left menu), on the **Prediction Resources** tab, copy the **example Query** at the bottom of the page.
 
-    This action opens browser tab with the endpoint URL in the address bar.
+    Paste the URL into a new browser tab.
 
     The URL has your app ID, key, and slot name. The V3 prediction endpoint URL looks like:
 
-    `https://REGION.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-KEY&<optional-name-value-pairs>&query=UTTERANCE-TEXT.`
+    `https://REGION.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE`
 

articles/cognitive-services/LUIS/luis-get-started-create-app.md

@@ -1,16 +1,8 @@
 ---
 title: "Quickstart: create app - LUIS"
-titleSuffix: Azure Cognitive Services
 description:  This quickstart shows how to create a LUIS app that uses the prebuilt domain `HomeAutomation` for turning lights and appliances on and off. This prebuilt domain provides intents, entities, and example utterances for you. When you're finished, you'll have a LUIS endpoint running in the cloud.
-services: cognitive-services
-author: diberry
-ms.custom: seodec18
-manager: nitinme
-ms.service: cognitive-services
-ms.subservice: language-understanding
 ms.topic: quickstart
-ms.date: 12/17/2019
-ms.author: diberry
+ms.date: 03/24/2020
 #Customer intent: As a new user, I want to quickly get a LUIS app created so I can understand the model and actions to train, test, publish, and query.
 ---
 
@@ -25,11 +17,11 @@ In this quickstart, create a LUIS app that uses the prebuilt domain `HomeAutomat
 ## Create a new app
 You can create and manage your applications on **My Apps**.
 
-1. In the LUIS portal, on the My apps list, select **+ Create**.
+1. On the My apps list, select **+ New app for conversation**.
 
-    ![In the LUIS portal, on the My apps list, select '+ Create.](./media/create-app-in-portal.png)
+1. In the dialog box, name your application `Home Automation`. Select **English** as the culture. The description is optional and isn't used for authoring or prediction. The prediction resource is also optional when creating a LUIS app. Select **Done**.
 
-1. In the dialog box, name your application `Home Automation` then select **Done**. LUIS creates the app. The description is optional and isn't used for authoring or prediction. The prediction resource is also optional when creating a LUIS app. When you publish your app to production, you should assign a prediction resource so your app can handle many requests.
+    LUIS creates the app. When you publish your app to production, you should assign a prediction resource so your app can handle many requests.
 
     ![In the dialog box, name your application `Home Automation`](./media/create-new-app-details.png)
 
@@ -62,23 +54,25 @@ Select the **HomeAutomation.TurnOff** intent. You can see that the intent contai
 [!INCLUDE [LUIS How to Train steps](includes/howto-train.md)]
 
 ## Test your app
-Once you've trained your app, you can test it. Select **Test**. Type a test utterance like `Turn off the lights` into the interactive test pane, and press Enter.
+Once you've trained your app, you can test it.
 
-```
-Turn off the lights
-```
+1. Select **Test** from the top-right navigation. 1. Type a test utterance like `Turn off the lights` into the interactive test pane, and press Enter.
 
-Check that the top scoring intent corresponds to the intent you expected for each test utterance.
+    ```
+    Turn off the lights
+    ```
+
+    Check that the top scoring intent corresponds to the intent you expected for each test utterance.
 
-In this example, `Turn off the lights` is correctly identified as the top scoring intent of **HomeAutomation.TurnOff**.
+    In this example, `Turn off the lights` is correctly identified as the top scoring intent of **HomeAutomation.TurnOff**.
 
-![Screenshot of Test panel with utterance highlighted](media/luis-quickstart-new-app/review-test-inspection-pane-in-portal.png)
+    ![Screenshot of Test panel with utterance highlighted](media/luis-quickstart-new-app/review-test-inspection-pane-in-portal.png)
 
-Select **Inspect** to review more information about the prediction.
+1. Select **Inspect** to review more information about the prediction.
 
-![Screenshot of Test panel with inspection information](media/luis-quickstart-new-app/test.png)
+    ![Screenshot of Test panel with inspection information](media/luis-quickstart-new-app/test.png)
 
-Select **Test** again to collapse the test pane.
+1. Close the test pane.
 
 <a name="publish-your-app"></a>
 
@@ -92,14 +86,14 @@ Select **Test** again to collapse the test pane.
 
 [!INCLUDE [LUIS How to get endpoint first step](./includes/v3-prediction-endpoint.md)]
 
-1. In the browser address bar, for the query string, make sure the following name and value bars are in the URL. If they are not in the query string, add them:
+2. In the browser address bar, for the query string, make sure the following name and value bars are in the URL. If they are not in the query string, add them:
 
     |Name/value pair|
     |--|
     |`verbose=true`|
     |`show-all-intents=true`|
 
-1. In the browser address bar, go to the end of the URL and enter `turn off the living room light` for the _query_ value, then press Enter.
+3. In the browser address bar, go to the end of the URL and enter `turn off the living room light` for the _query_ value, then press Enter.
 
     ```json
     {