Merge pull request #96020 from diberry/diberry/1114-luis-howto-2

[Cogsvcs] LUIS - Spell Check & Descriptors

Author: v-albemi

articles/cognitive-services/LUIS/luis-how-to-add-features.md

@@ -1,5 +1,5 @@
 ---
-title: Phrase lists - LUIS
+title: Descriptors - LUIS
 titleSuffix: Azure Cognitive Services
 description: Use Language Understanding (LUIS) to add app features that can improve the detection or prediction of intents and entities that categories and patterns
 services: cognitive-services
@@ -9,51 +9,46 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 11/03/2019
+ms.date: 11/14/2019
 ms.author: diberry
 ---
 
-# Use phrase lists to boost signal of word list
+# Use descriptors to boost signal of word list
 
 You can add features to your LUIS app to improve its accuracy. Features help LUIS by providing hints that certain words and phrases are part of an app domain vocabulary. 
 
-A [phrase list](luis-concept-feature.md) includes a group of values (words or phrases) that belong to the same class and must be treated similarly (for example, names of cities or products). What LUIS learns about one of them is automatically applied to the others as well. This list is not the same thing as a [list entity](reference-entity-list.md) (exact text matches) of matched words.
+A [descriptor](luis-concept-feature.md) (phrase list) includes a group of values (words or phrases) that belong to the same class and must be treated similarly (for example, names of cities or products). What LUIS learns about one of them is automatically applied to the others as well. This list is not the same thing as a [list entity](reference-entity-list.md) (exact text matches) of matched words.
 
-A phrase list adds to the vocabulary of the app domain as a second signal to LUIS about those words.
+A descriptor adds to the vocabulary of the app domain as a second signal to LUIS about those words.
 
-Review [feature concepts](luis-concept-feature.md) to understand when and why to use a phrase list. 
+Review [feature concepts](luis-concept-feature.md) to understand when and why to use a descriptor. 
 
-[!INCLUDE [Waiting for LUIS portal refresh](./includes/wait-v3-upgrade.md)]
+[!INCLUDE [Uses preview portal](includes/uses-portal-preview.md)]
 
-## Add phrase list
+## Add descriptor
 
-LUIS allows up to 10 phrase lists per app. 
+1. Open your app by clicking its name on **My Apps** page, and then click **Build**, then click **Descriptors** in your app's left panel. 
 
-1. Open your app by clicking its name on **My Apps** page, and then click **Build**, then click **Phrase lists** in your app's left panel. 
-
-1. On the **Phrase lists** page, click **Create new phrase list**. 
+1. On the **Descriptors** page, click **+ Add Descriptor**. 
 
-1. In the **Add Phrase List** dialog box, type `Cities` as the name of the phrase list. In the **Value** box, type the values of the phrase list. You can type one value at a time, or a set of values separated by commas, and then press **Enter**.
-
-    ![Add phrase list Cities](./media/luis-add-features/add-phrase-list-cities.png)
-
-1. LUIS can propose related values to add to your phrase list. Click **Recommend** to get a group of proposed values that are semantically related to the added value(s). You can click any of the proposed values, or click **Add All** to add them all.
+1. In the **Create new phrase list descriptor** dialog box, enter a name such as `Cities` for the descriptor. In the **Value** box, type the values of the descriptors, such as `Seattle`. You can type one value at a time, or a set of values separated by commas, and then press **Enter**.
 
-    ![Phrase List Proposed Values - add all](./media/luis-add-features/related-values.png)
+    > [!div class="mx-imgBorder"]
+    > ![Add descriptor Cities](./media/luis-add-features/add-phrase-list-cities.png)
 
-1. Click **These values are interchangeable** if the added phrase list values are alternatives that can be used interchangeably.
+    Once you have entered enough values for LUIS, suggestions appear. You can **+ Add all** of the proposed values, or select individual terms.
 
-    ![Phrase List Proposed Values - select interchangeable box](./media/luis-add-features/interchangeable.png)
+1. Keep **These values are interchangeable** checked if the added descriptor values are alternatives that can be used interchangeably.
 
-1. Click **Done**. The "Cities" phrase list is added to the **Phrase lists** page.
+1. Select **Done**. The new descriptor is added to the **Descriptors** page.
 
 <a name="edit-phrase-list"></a>
 <a name="delete-phrase-list"></a>
 <a name="deactivate-phrase-list"></a>
 
 > [!Note]
-> You can delete, or deactivate a phrase list from the contextual toolbar on the **Phrase lists** page.
+> You can delete, or deactivate a descriptor from the contextual toolbar on the **Descriptors** page.
 
 ## Next steps
 
-After adding, editing, deleting, or deactivating a phrase list, [train and test the app](luis-interactive-test.md) again to see if performance improves.
+After adding, editing, deleting, or deactivating a descriptor, [train and test the app](luis-interactive-test.md) again to see if performance improves.

articles/cognitive-services/LUIS/luis-tutorial-bing-spellcheck.md

@@ -9,16 +9,14 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 10/25/2019
+ms.date: 11/15/2019
 ms.author: diberry
 ---
 
 # Correct misspelled words with Bing Spell Check
 
 You can integrate your LUIS app with [Bing Spell Check API V7](https://azure.microsoft.com/services/cognitive-services/spell-check/) to correct misspelled words in utterances before LUIS predicts the score and entities of the utterance. 
 
-[!INCLUDE [Waiting for LUIS portal refresh](./includes/wait-v3-upgrade.md)]
-
 [!INCLUDE [Not supported in V3 API prediction endpoint](./includes/v2-support-only.md)]