[Cogsvcs] LUIS - labeling

Author: diberry

articles/cognitive-services/LUIS/label-entity-example-utterance.md

@@ -1,42 +1,44 @@
 ---
 title: Label entity example utterance
-description: Learn how to label a machine-learning entity with subcomponents in an example utterance in an intent detail page of the LUIS portal.
+description: Learn how to label a machine-learning entity with subentities in an example utterance in an intent detail page of the LUIS portal.
 ms.topic: conceptual
-ms.date: 05/17/2020
+ms.date: 05/20/2020
 #Customer intent: As a new user, I want to label a machine-learning entity in an example utterance.
 ---
 
 # Label machine-learning entity in an example utterance
 
 Labeling an entity in an example utterance gives LUIS an example of what the entity is and where the entity can appear in the utterance.
 
+You can label machine-learned entities and subentities.
+
+Because you can't label regular expression, list or prebuilt entities, create a entity or subentity, then add these entities are features, when applicable, to the entity or subentity.
+
 ## Label example utterances from the Intent detail page
 
+To label examples of entities within the utterance, select the utterance's intent.
+
 1. Sign in to the [LUIS portal](https://www.luis.ai), and select your **Subscription** and **Authoring resource** to see the apps assigned to that authoring resource.
 1. Open your app by selecting its name on **My Apps** page.
 1. Select the Intent that has the example utterances you want to label for extraction with an entity.
 1. Select the text you want to label then select the entity.
 
+## Two techniques to label entities
+
+Two labeling techniques are supported on the Intent detail page.
+* Select entity or subentity from **[Entity Palette](label-with-the-entity-palette-visible)** then select within example utterance text. This is the recommended technique because you can visually verify you are working with the correct entity or subentity, according to your schema.
+* Select within the example utterance text first. When you do this, a pop-up menu of [labeling choices](#label-entity-from-in-place-menu) is presented.
+
 ## Label with the Entity Palette visible
 
-After you've planned your schema with entities, keep the **Entity palette** visible while labeling. The **Entity palette** is a reminder of what your entities you planned to extract.
+After you've [planned your schema with entities](luis-how-plan-your-app.md), keep the **Entity palette** visible while labeling. The **Entity palette** is a reminder of what entities you planned to extract.
 
 To access the **Entity Palette**, select the **@** symbol in the contextual toolbar above the example utterance list.
 
 > [!div class="mx-imgBorder"]
 > ![Screenshot of entity palette on Intent details page.](media/label-utterances/entity-palette-from-tool-bar.png)
 
-## Label entity from in-place menu
-
-Consider the example utterance, `hi, please I want a cheese pizza in 20 minutes`.
-
-1. Select the left-most text, then select the right-most text of the entity, then from the in-place menu, pick the entity you want to label with.
-
-    > [!div class="mx-imgBorder"]
-    > ![Label complete machine-learning entity](media/label-utterances/label-steps-in-place-menu.png)
-
-
-## Label entity from Entity Palette
+## How to label entity from Entity Palette
 
 The entity palette offers an alternative to the previous labeling experience. It allows you to brush over text to instantly label it with an entity.
 
@@ -65,6 +67,17 @@ Entity roles are labeled using the **Entity palette**.
 1. Below the list of entities, select an existing role.
 1. In the example utterance text, label the text with the entity role.
 
+## How to label entity from in-place menu
+
+Labeling in-place allows you to quickly select the text within the utterance and label it. You can also create a machine learning entity or list entity from the labeled text.
+
+Consider the example utterance, `hi, please I want a cheese pizza in 20 minutes`.
+
+Select the left-most text, then select the right-most text of the entity, then from the in-place menu, pick the entity you want to label with.
+
+> [!div class="mx-imgBorder"]
+> ![Label complete machine-learning entity](media/label-utterances/label-steps-in-place-menu.png)
+
 ## Review labeled text
 
 After labeling, review the example utterance and ensure the selected span of text has been underlined with the chosen entity. The solid line indicates the text has been labeled.
@@ -82,12 +95,12 @@ If you relabel text that is already labeled, LUIS may split or merge existing la
 
 ## Labeling for punctuation
 
-You do not need to label for punctuation. Use [application settings](luis-reference-application-settings.md) _word forms_ to control if punctuation impacts utterance predictions.
+You do not need to label for punctuation. Use [application settings](luis-reference-application-settings.md) to control how punctuation impacts utterance predictions.
 
 ## Unlabel entities
 
 > [!NOTE]
-> Only machine learned entities can be unlabeled.
+> Only machine learned entities can be unlabeled. You can't label or unlabel regular expression entities, list entities, or prebuilt entities.
 
 To unlabel an entity, select the entity and select **Unlabel** from the in-place menu.