[Cogsvcs] LUIS - Public Issue 51563

Author: diberry

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

@@ -9,28 +9,28 @@ ms.custom: seodec18
 ms.service: cognitive-services
 ms.subservice: language-understanding
 ms.topic: conceptual
-ms.date: 11/14/2019
+ms.date: 04/02/2020
 ms.author: diberry
 ---
 
 # 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. 
+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 [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 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 descriptor. 
+Review [feature concepts](luis-concept-feature.md) to understand when and why to use a descriptor.
 
 [!INCLUDE [Uses preview portal](includes/uses-portal-preview.md)]
 
 ## Add descriptor
 
-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 **Descriptors** in your app's left panel.
+
+1. On the **Descriptors** page, click **+ Add Descriptor**.
 
-1. On the **Descriptors** page, click **+ Add Descriptor**. 
- 
 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**.
 
     > [!div class="mx-imgBorder"]
@@ -40,6 +40,8 @@ Review [feature concepts](luis-concept-feature.md) to understand when and why to
 
 1. Keep **These values are interchangeable** checked if the added descriptor values are alternatives that can be used interchangeably.
 
+1. The phrase list can apply to the entire app with the **Global** setting, or to a specific model (intent or entity). If you create the phrase list, as a _descriptor_ from an intent or entity, the toggle is set to not global. In this case, the meaning of the toggle is that the descriptor is a feature to only that model, therefore, _not global_ to the application.
+
 1. Select **Done**. The new descriptor is added to the **Descriptors** page.
 
 <a name="edit-phrase-list"></a>