docs: DOC-285: Annotation Limit settings (#7236)

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

Author: caitlinwheeless

docs/source/guide/project_settings_lse.md

@@ -454,6 +454,34 @@ The following options supersede what you specified under [**Annotations > Task S
 
 </dd>
 
+<dt id="annotation-limit">Annotation Limit</dt>
+
+<dd>
+
+Set limits on how many tasks each individual user can annotate. This can be useful if you are concerned with preventing any potential bias that might arise from a small set of power users completing a majority of project tasks. 
+
+When an annotator reaches their limit, they will see a notification telling them that they have been paused. When paused, an annotator can no longer access the project. 
+
+| Field          | Description    |
+| ------------- | ------------ |
+| **Limit by Number of Tasks**    | Set a specific number of tasks each annotator is able to complete before their progress is paused.   |
+| **Limit by Percentage of Tasks** | Calculate the number of tasks each annotator is able to complete as a percentage of tasks within the project.  |
+
+You can set one or both values. Annotators will be paused when they reach whichever limit is smaller.  
+
+To unpause annotators:
+
+* You can manually unpause annotators using the **Paused** toggle available in the Members dashboard.  
+* If you increase the limits, previously paused annotators will regain access. 
+* If you are using a percentage-based limit and you add more tasks to a project, previously paused annotators will regain access. 
+
+For more information about pausing annotators, including how to manually pause specific annotators, see [Pause an annotator](quality#Pause-an-annotator).
+
+!!! note
+    Pauses affect users in Annotator and Reviewer roles. So, for example, if a Reviewer is also annotating tasks and they hit the annotation limit, they will be unable to regain access to the project to review annotations unless they are unpaused. 
+
+</dd>
+
 <dt id="task-agreement">Task Agreement</dt>
 
 <dd>

docs/source/guide/quality.md

@@ -118,9 +118,11 @@ For example, if you're developing a dataset of OCR images, and 90% of your tasks
 
 ## Pause an annotator
 
-For organizations with a large number of annotators, it might prove useful to pause an annotator's progress. This might be useful for annotators that are performing poorly or exhibiting behavior that might indicate they have automated their work (bot behavior). 
+For organizations with a large number of annotators, it might prove useful to pause an annotator's progress. This might be helpful for annotators that are performing poorly or exhibiting behavior that might indicate they have automated their work (bot behavior). 
 
-You can pause annotators from the Members dashboard in a project. This action is only available next to users in the Annotator and Reviewer roles:
+### Manually pause an annotator
+
+You can manually pause annotators from the Members dashboard in a project. This action is only available next to users in the Annotator and Reviewer roles:
 
 ![Screenshot of pause](/images/review/pause.png)
 
@@ -134,15 +136,22 @@ When a user is paused, the following occurs:
 
 !!! info Tip
 
-    If you have [custom scripts](scripts) enabled, you can automatically pause an annotator based on certain behaviors and then customize the message that appears on their screen. 
+    If you hover over the **Paused** indicator, you can see the message that was shown to the user when they were paused. If a user was manually paused, it also shows who initiated the action.  
 
-    For more information, see [Custom script examples - Pause an annotator](script_examples#Pause-an-annotator).
+    ![Screenshot of hover](/images/review/paused-tooltip.png)
 
-!!! info Tip
+### Automatically pause annotators 
 
-    If you hover over the **Paused** indicator, you can see the message that was shown to the user when they were paused. If a user was manually paused, it also shows who initiated the action.  
+#### Annotation Limit settings
+
+You can use **Settings > Quality > Annotation Limit** to set limits on how many tasks an annotator is able to complete before they are paused. For more information, see [Annotation Limit](project_settings_lse#annotation-limit). 
+
+#### Behavior-based triggers
+
+If you have [custom scripts](scripts) enabled, you can automatically pause an annotator based on certain behaviors and then customize the message that appears on their screen. 
+
+For more information, see [Custom script examples - Pause an annotator](script_examples#Pause-an-annotator).
 
-    ![Screenshot of hover](/images/review/paused-tooltip.png)
 
 ## Verify model and annotator performance