Merge pull request #218313 from sdgilley/sdg-hierarchical-labels

add hierarchical labels

Author: tamarakhader

articles/machine-learning/how-to-create-image-labeling-projects.md

@@ -207,7 +207,7 @@ View and change details of your project.  In this tab you can:
 
 [!INCLUDE [access](../../includes/machine-learning-data-labeling-access.md)]
 
-## Add new label class to a project
+## Add new labels to a project
 
 [!INCLUDE [add-label](../../includes/machine-learning-data-labeling-add-label.md)]
 

articles/machine-learning/how-to-create-text-labeling-projects.md

@@ -114,7 +114,7 @@ To directly upload your data:
 > [!NOTE]
 > Incremental refresh is available for projects that use tabular (.csv or .tsv) dataset input. However, only new tabular files are added.  Changes to existing tabular files will not be recognized from the refresh.
 
-## Specify label classes
+## Specify label categories
 
 [!INCLUDE [classes](../../includes/machine-learning-data-labeling-classes.md)]
 
@@ -193,7 +193,7 @@ View and change details of your project.  In this tab you can:
 
 [!INCLUDE [access](../../includes/machine-learning-data-labeling-access.md)]
 
-## Add new label class to a project
+## Add new labels to a project
 
 [!INCLUDE [add-label](../../includes/machine-learning-data-labeling-add-label.md)]
 

articles/machine-learning/media/how-to-create-labeling-projects/add-flat-labels.png

@@ -13,8 +13,8 @@ Use these steps to add one or more labels to a project:
 1. Select the project on the main **Data Labeling** page.
 1. At the top right of the page, toggle **Running** to **Paused** to stop labelers from their activity.
 1. Select the **Details** tab.
-1. In the list on the left, select **Label classes**.
-1. At the top of the list, select **+ Add Labels**
+1. In the list on the left, select **Label categories**.
+1. Modify your labels.
     ![Add a label](../articles/machine-learning/media/how-to-create-labeling-projects/add-label.png)
 1. In the form, add your new label. Then choose how to continue the project.  Since you've changed the available labels, you choose how to treat the already labeled data:
     * Start over, removing all existing labels.  Choose this option if you want to start labeling from the beginning with the new full set of labels. 

articles/machine-learning/media/how-to-create-labeling-projects/add-label-groups.png

@@ -6,6 +6,16 @@ ms.date: 09/23/2021
 ms.author: sdgilley
 ---
 
-On the **Label classes** page, specify the set of classes to categorize your data. Your labelers' accuracy and speed are affected by their ability to choose among the classes. For instance, instead of spelling out the full genus and species for plants or animals, use a field code or abbreviate the genus.
+On the **Label categories** page, specify the set of classes to categorize your data. Your labelers' accuracy and speed are affected by their ability to choose among the classes. For instance, instead of spelling out the full genus and species for plants or animals, use a field code or abbreviate the genus.
 
-Enter one label per row. Use the **+** button to add a new row. If you have more than three or four labels but fewer than 10, you may want to prefix the names with numbers ("1: ", "2: ") so the labelers can use the number keys to speed their work.
+You can use either a flat list or create groups of labels.  
+
+* To create a flat list, select **+ Add label category** to create each label.
+
+    :::image type="content" source="../articles/machine-learning/media/how-to-create-labeling-projects/add-flat-labels.png" alt-text="Screenshot: Add flat structure for labels.":::
+
+* To create labels in different groups, select **+ Add label category** to create the top level labels.  Then select the **+** under each top level to create the next level of labels for that category.  You can create up to six levels for any grouping.
+    
+    :::image type="content" source="../articles/machine-learning/media/how-to-create-labeling-projects/add-label-groups.png" alt-text="Screenshot: Add groups of labels.":::
+
+Labels at any level may be selected during the tagging process.  For example, the labels `Animal`, `Animal/Cat`,  `Animal/Dog`, `Color`, `Color/Black`, `Color/White`, and `Color/Silver` are all available choices for a label.  In a multi-label project, there is no requirement to pick one of each category.  If that is your intent, make sure to add this information in your instructions.