docs: DOC-272: Labeling param for Taxonomy (#6876)

Co-authored-by: caitlinwheeless <[email protected]>
Co-authored-by: robot-ci-heartex <[email protected]>
Co-authored-by: caitlinwheeless <[email protected]>

Author: 3 people

docs/source/tags/taxonomy.md

@@ -30,6 +30,7 @@ Use with the following data types: audio, image, HTML, paragraphs, text, time se
 | [placeholder=] | <code>string</code> |  | What to display as prompt on the input |
 | [perRegion] | <code>boolean</code> |  | Use this tag to classify specific regions instead of the whole object |
 | [perItem] | <code>boolean</code> |  | Use this tag to classify specific items inside the object instead of the whole object |
+| [labeling] | <code>boolean</code> |  | Use taxonomy to label regions in text. Only supported with <Text> and <HyperText> object tags. |
 | [legacy] | <code>boolean</code> |  | Use this tag to enable the legacy version of the Taxonomy tag. The legacy version supports the ability for annotators to add labels as needed. However, when true, the `apiUrl` parameter is not usable. |
 
 ### Example

docs/source/templates/taxonomy.md

@@ -32,6 +32,17 @@ In both options, the following tags are required:
     <Taxonomy name="taxonomy" toName="text">
     ```
 
+## Taxonomy as a labeling tool
+
+Typically, the `<Taxonomy>` tag is used to perform classification tasks. However, if you set `labeling="true"`, you can apply your taxonomy choices to regions within text. This can be especially useful for NER projects. 
+
+Note that the `labeling` parameter is only supported when using `<Text> `or `<HyperText>` object tags. 
+
+![Screenshot of taxonomy as NER](/images/templates-misc/taxonomy_ner.png)
+
+!!! info Tip
+    You can use the `color` parameter on your taxonomy [`<Choice>`](/tags/choice) to color-code selected regions within the text. 
+
 ## Taxonomies defined using nested `Choice` tags
 
 Use the [`Choice`](/tags/choice.html) tag to specify the taxonomy. Nest choices under [`Choice`](/tags/choice.html) tags to create layers in the taxonomy.

docs/themes/v2/source/images/templates-misc/taxonomy_ner.png

@@ -86,6 +86,7 @@ import { errorBuilder } from "../../../core/DataValidator/ConfigValidator";
  * @param {string} [placeholder=]         - What to display as prompt on the input
  * @param {boolean} [perRegion]           - Use this tag to classify specific regions instead of the whole object
  * @param {boolean} [perItem]             - Use this tag to classify specific items inside the object instead of the whole object
+ * @param {boolean} [labeling]            - Use taxonomy to label regions in text. Only supported with <Text> and <HyperText> object tags.
  * @param {boolean} [legacy]              - Use this tag to enable the legacy version of the Taxonomy tag. The legacy version supports the ability for annotators to add labels as needed. However, when true, the `apiUrl` parameter is not usable.
  */
 const TagAttrs = types.model({