Merge pull request #223400 from laujan/55552-preliminary-updates

55552 preliminary updates

Author: prmerger-automator[bot]

articles/applied-ai-services/form-recognizer/deploy-label-tool.md

@@ -7,17 +7,19 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 10/10/2022
+ms.date: 01/09/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-2.1.0'
 recommendations: false
 ---
 
 # Deploy the Sample Labeling tool
 
+**This article applies to:** ![Form Recognizer v2.1 checkmark](media/yes-icon.png) **Form Recognizer v2.1**.
+
 >[!TIP]
 >
-> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio ](https://formrecognizer.appliedai.azure.com/studio).
+> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio](https://formrecognizer.appliedai.azure.com/studio).
 > * The v3.0 Studio supports any model trained with v2.1 labeled data.
 > * You can refer to the [API migration guide](v3-migration-guide.md) for detailed information about migrating from v2.1 to v3.0.
 > * *See* our [**REST API**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) or [**C#**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**Java**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**JavaScript**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), or [Python](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) SDK quickstarts to get started with the v3.0 version.
@@ -94,7 +96,7 @@ Follow these steps to create a new resource using the Azure portal:
 
 ### Continuous deployment
 
-After you have created your web app, you can enable the continuous deployment option:
+After you've created your web app, you can enable the continuous deployment option:
 
 * From the left pane, choose **Container settings**.
 * In the main window, navigate to Continuous deployment and toggle between the **On** and **Off** buttons to set your preference:

articles/applied-ai-services/form-recognizer/label-tool.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 10/10/2022
+ms.date: 01/09/2023
 ms.author: lajanuar
 monikerRange: 'form-recog-2.1.0'
 recommendations: false
@@ -18,6 +18,8 @@ recommendations: false
 <!-- markdownlint-disable MD034 -->
 # Train a custom model using the Sample Labeling tool
 
+**This article applies to:** ![Form Recognizer v2.1 checkmark](media/yes-icon.png) **Form Recognizer v2.1**.
+
 >[!TIP]
 >
 > * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio](https://formrecognizer.appliedai.azure.com/studio).
@@ -35,7 +37,7 @@ In this article, you'll use the Form Recognizer REST API with the Sample Labelin
 
 * Azure subscription - [Create one for free](https://azure.microsoft.com/free/cognitive-services)
 * Once you have your Azure subscription, <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer"  title="Create a Form Recognizer resource"  target="_blank">create a Form Recognizer resource </a> in the Azure portal to get your key and endpoint. After it deploys, select **Go to resource**.
-  * You'll need the key and endpoint from the resource you create to connect your application to the Form Recognizer API. You'll paste your key and endpoint into the code below later in the quickstart.
+  * You'll need the key and endpoint from the resource you create to connect your application to the Form Recognizer API. You'll paste your key and endpoint into the code later in the quickstart.
   * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 * A set of at least six forms of the same type. You'll use this data to train the model and test a form. You can use a [sample data set](https://go.microsoft.com/fwlink/?linkid=2090451) (download and extract *sample_data.zip*) for this quickstart. Upload the training files to the root of a blob storage container in a standard-performance-tier Azure Storage account.
 
@@ -69,7 +71,7 @@ You'll use the Docker engine to run the Sample Labeling tool. Follow these steps
 
     | Container | Minimum | Recommended|
     |:--|:--|:--|
-    |Sample Labeling tool|2 core, 4-GB memory|4 core, 8-GB memory|
+    |Sample Labeling tool|`2` core, 4-GB memory|`4` core, 8-GB memory|
 
     Install Docker on your machine by following the appropriate instructions for your operating system:
 
@@ -89,7 +91,7 @@ You'll use the Docker engine to run the Sample Labeling tool. Follow these steps
      docker run -it -p 3000:80 mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1 eula=accept
     ```
 
-   This command will make the Sample Labeling tool available through a web browser. Go to `http://localhost:3000`.
+   This command will make the sample-labeling tool available through a web browser. Go to `http://localhost:3000`.
 
 > [!NOTE]
 > You can also label documents and train models using the Form Recognizer REST API. To train and Analyze with the REST API, see [Train with labels using the REST API and Python](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/FormRecognizer/rest/python-labeled-data.md).
@@ -171,6 +173,7 @@ Next, you'll create tags (labels) and apply them to the text elements that you w
    1. Press Enter to save the tag.
 1. In the main editor, select words from the highlighted text elements or a region you drew in.
 1. Select the tag you want to apply, or press the corresponding keyboard key. The number keys are assigned as hotkeys for the first 10 tags. You can reorder your tags using the up and down arrow icons in the tag editor pane.
+1. Follow these steps to label at least five of your forms.
     > [!Tip]
     > Keep the following tips in mind when you're labeling your forms:
     >
@@ -186,8 +189,6 @@ Next, you'll create tags (labels) and apply them to the text elements that you w
 
 :::image type="content" source="media/label-tool/main-editor-2-1.png" alt-text="Main editor window of Sample Labeling tool.":::
 
-Follow the steps above to label at least five of your forms.
-
 ### Specify tag value types
 
 You can set the expected data type for each tag. Open the context menu to the right of a tag and select a type from the menu. This feature allows the detection algorithm to make assumptions that will improve the text-detection accuracy. It also ensures that the detected values will be returned in a standardized format in the final JSON output. Value type information is saved in the **fields.json** file in the same path as your label files.
@@ -262,7 +263,7 @@ Choose the Train icon on the left pane to open the Training page. Then select th
 
 :::image type="content" source="media/label-tool/train-screen.png" alt-text="Training view.":::
 
-After training finishes, examine the **Average Accuracy** value. If it's low, you should add more input documents and repeat the steps above. The documents you've already labeled will remain in the project index.
+After training finishes, examine the **Average Accuracy** value. If it's low, you should add more input documents and repeat the labeling steps. The documents you've already labeled will remain in the project index.
 
 > [!TIP]
 > You can also run the training process with a REST API call. To learn how to do this, see [Train with labels using Python](https://github.com/Azure-Samples/cognitive-services-quickstart-code/blob/master/python/FormRecognizer/rest/python-labeled-data.md).
@@ -271,14 +272,16 @@ After training finishes, examine the **Average Accuracy** value. If it's low, yo
 
 With Model Compose, you can compose up to 100 models to a single model ID. When you call Analyze with the composed `modelID`, Form Recognizer will first classify the form you submitted, choose the best matching model, and then return results for that model. This operation is useful when incoming forms may belong to one of several templates.
 
-To compose models in the Sample Labeling tool, select the Model Compose (merging arrow) icon on the left. On the left, select the models you wish to compose together. Models with the arrows icon are already composed models.
-Choose the **Compose button**. In the pop-up, name your new composed model and select **Compose**. When the operation completes, your newly composed model should appear in the list.
+* To compose models in the Sample Labeling tool, select the Model Compose (merging arrow) icon from the navigation bar.
+* Select the models you wish to compose together. Models with the arrows icon are already composed models.
+* Choose the **Compose button**. In the pop-up, name your new composed model and select **Compose**.
+* When the operation completes, your newly composed model should appear in the list.
 
 :::image type="content" source="media/label-tool/model-compose.png" alt-text="Model compose UX view.":::
 
 ## Analyze a form
 
-Select the Analyze (light bulb) icon on the left to test your model. Select source 'Local file'. Browse for a file and select a file from the sample dataset that you unzipped in the test folder. Then choose the **Run analysis** button to get key/value pairs, text and tables predictions for the form. The tool will apply tags in bounding boxes and will report the confidence of each tag.
+Select the Analyze icon from the navigation bar to test your model. Select source 'Local file'. Browse for a file and select a file from the sample dataset that you unzipped in the test folder. Then choose the **Run analysis** button to get key/value pairs, text and tables predictions for the form. The tool will apply tags in bounding boxes and will report the confidence of each tag.
 
 :::image type="content" source="media/analyze.png" alt-text="Screenshot: analyze-a-custom-form window":::
 
@@ -301,7 +304,7 @@ Go to your project settings page (slider icon) and take note of the security tok
 
 ### Restore project credentials
 
-When you want to resume your project, you first need to create a connection to the same blob storage container. To do so, repeat the steps above. Then, go to the application settings page (gear icon) and see if your project's security token is there. If it isn't, add a new security token and copy over your token name and key from the previous step. Select **Save** to retain your settings.
+When you want to resume your project, you first need to create a connection to the same blob storage container. To do so, repeat the steps. Then, go to the application settings page (gear icon) and see if your project's security token is there. If it isn't, add a new security token and copy over your token name and key from the previous step. Select **Save** to retain your settings.
 
 ### Resume a project
 

articles/applied-ai-services/form-recognizer/quickstarts/try-sample-label-tool.md

@@ -9,7 +9,6 @@ ms.subservice: forms-recognizer
 ms.topic: quickstart
 ms.date: 10/10/2022
 ms.author: lajanuar
-ms.custom: cog-serv-seo-may-2021, ignite-fall-2021, mode-other
 monikerRange: 'form-recog-2.1.0'
 recommendations: false
 ---
@@ -20,11 +19,11 @@ recommendations: false
 <!-- markdownlint-disable MD029 -->
 # Get started with the Form Recognizer Sample Labeling tool
 
-[!INCLUDE [applies to v2.1](../includes/applies-to-v2-1.md)]
+**This article applies to:** ![Form Recognizer v2.1 checkmark](../media/yes-icon.png) **Form Recognizer v2.1**.
 
 >[!TIP]
 >
-> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio ](https://formrecognizer.appliedai.azure.com/studio).
+> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio](https://formrecognizer.appliedai.azure.com/studio).
 > * The v3.0 Studio supports any model trained with v2.1 labeled data.
 > * You can refer to the API migration guide for detailed information about migrating from v2.1 to v3.0.
 > * *See* our [**REST API**](get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) or [**C#**](get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**Java**](get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**JavaScript**](get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), or [Python](get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) SDK quickstarts to get started with the v3.0 version.
@@ -243,7 +242,7 @@ Use the tags editor pane to create a new tag you'd like to identify:
 
 1. In the main editor, select the total value from the highlighted text elements.
 
-1. Select the Total tag to apply to the value, or press the corresponding keyboard key. The number keys are assigned as hotkeys for the first 10 tags. You can reorder your tags using the up and down arrow icons in the tag editor pane.
+1. Select the Total tag to apply to the value, or press the corresponding keyboard key. The number keys are assigned as hotkeys for the first 10 tags. You can reorder your tags using the up and down arrow icons in the tag editor pane. Follow these steps to label all five forms in the sample dataset:
 
     > [!Tip]
     > Keep the following tips in mind when you're labeling your forms:
@@ -259,8 +258,6 @@ Use the tags editor pane to create a new tag you'd like to identify:
     > * To remove an applied tag without deleting the tag itself, select the tagged rectangle on the document view and press the delete key.
     >
 
-1. Continue to follow the steps above to label all five forms in the sample dataset.
-
   :::image type="content" source="../media/label-tool/custom-1.jpg" alt-text="Label the samples.":::
 
 #### Train a custom model
@@ -276,7 +273,7 @@ Choose the Train icon on the left pane to open the Training page. Then select th
 
 #### Analyze a custom form
 
-1. Select the **Analyze** (light bulb) icon on the left to test your model.
+1. Select the **Analyze** icon from the navigation bar to test your model.
 
 1. Select source **Local file** and  browse for a file to select from the sample dataset that you unzipped in the test folder.
 

articles/applied-ai-services/form-recognizer/supervised-table-tags.md

@@ -1,24 +1,26 @@
 ---
-title: "How to use table tags to train your custom template model - Form Recognizer"
+title: "Train your custom template model with the sample-labeling tool and table tags"
 titleSuffix: Azure Applied AI Services
 description: Learn how to effectively use supervised table tag labeling.
 author: laujan
 manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: how-to
-ms.date: 10/10/2022
+ms.date: 01/09/2023
 ms.author: lajanuar
 #Customer intent: As a user of the Form Recognizer custom model service, I want to ensure I'm training my model in the best way.
 monikerRange: 'form-recog-2.1.0'
 recommendations: false
 ---
 
-# Use table tags to train your custom template model
+# Train models with the sample-labeling tool
+
+**This article applies to:** ![Form Recognizer v2.1 checkmark](media/yes-icon.png) **Form Recognizer v2.1**.
 
 >[!TIP]
 >
-> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio ](https://formrecognizer.appliedai.azure.com/studio).
+> * For an enhanced experience and advanced model quality, try the [Form Recognizer v3.0 Studio](https://formrecognizer.appliedai.azure.com/studio).
 > * The v3.0 Studio supports any model trained with v2.1 labeled data.
 > * You can refer to the [API migration guide](v3-migration-guide.md) for detailed information about migrating from v2.1 to v3.0.
 > * *See* our [**REST API**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) or [**C#**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**Java**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), [**JavaScript**](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true), or [Python](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) SDK quickstarts to get started with version v3.0.