Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-rbac-roles-learn-more-links-format

Author: rolyon

articles/ai-services/.openpublishing.redirection.ai-services-from-applied.json

@@ -600,6 +600,32 @@
       "source_path_from_root": "/articles/ai-services/document-intelligence/language-support.md",
       "redirect_url": "/azure/ai-services/document-intelligence/language-support-ocr",
       "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-csharp-sdk.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/csharp-sdk.md",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-javascript-sdk.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/javascript-sdk.md",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-java-sdk.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/java-sdk.md",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-python-sdk.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/python-sdk.md",
+      "redirect_document_id": true
+    },
+    {
+      "source_path_from_root": "/articles/ai-services/document-intelligence/quickstarts/includes/v3-rest-api-sdk.md",
+      "redirect_url": "/azure/ai-services/document-intelligence/quickstarts/includes/rest-api-sdk.md",
+      "redirect_document_id": true
     }
+    
   ]
 }

articles/ai-services/document-intelligence/changelog-release-history.md

@@ -36,38 +36,52 @@ This reference article provides a version-based description of Document Intellig
 
 [**Samples**](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/documentintelligence/Azure.AI.DocumentIntelligence/samples/README.md)
 
+[**Migration guide**](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/documentintelligence/Azure.AI.DocumentIntelligence/MigrationGuide.md)
+
 ### [**Java**](#tab/java)
 
 * Document Intelligence **1.0.0-beta.1**
 * **Targets REST API 2023-10-31-preview by default**
 
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.1/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md#100-beta1-2023-11-16)
+
 [**Package (MVN)**](https://mvnrepository.com/artifact/com.azure/azure-ai-documentintelligence/1.0.0-beta.1)
 
 [**ReadMe**](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.1/sdk/documentintelligence/azure-ai-documentintelligence/README.md#azure-documentintelligence-client-library-for-java)
 
 [**Samples**](https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.1/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#examples)
 
+[**Migration guide**](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md)
+
 ### [**JavaScript**](#tab/javascript)
 
 * Document Intelligence **1.0.0-beta.1**
 * **Targets REST API 2023-10-31-preview by default**
 
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/documentintelligence/ai-document-intelligence-rest/CHANGELOG.md#100-beta1-2023-11-16)
+
 [**Package (npm)**](https://www.npmjs.com/package/@azure-rest/ai-document-intelligence)
 
 [**ReadMe**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest#readme)
 
-[**Samples**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/samples/v1-beta/typescript)
+[**Samples**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/samples/v1-beta/javascript)
+
+[**Migration guide**](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/documentintelligence/ai-document-intelligence-rest/MIGRATION-FR_v4-DI_v1.md)
 
 ### [**Python**](#tab/python)
 
 * Document Intelligence **1.0.0b1**
 * **Targets REST API 2023-10-31-preview by default**
 
+[**Changelog/Release History**](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md#100b1-2023-11-17)
+
 [**Package (PyPi)**](https://pypi.org/project/azure-ai-documentintelligence/)
 
-[**ReadMe**](https://github.com/Azure/azure-sdk-for-python/blob/7c42462ac662522a6fd21b17d2a20f4cd40d0356/sdk/documentintelligence/azure-ai-documentintelligence/README.md)
+[**ReadMe**](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/README.md)
+
+[**Samples**](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/samples)
 
-[**Samples**](https://github.com/Azure/azure-sdk-for-python/tree/7c42462ac662522a6fd21b17d2a20f4cd40d0356/sdk/documentintelligence/azure-ai-documentintelligence/samples)
+[**Migration guide**](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md)
 
 ---
 

articles/ai-services/document-intelligence/concept-document-intelligence-studio.md

@@ -41,14 +41,14 @@ The following image shows the landing page for Document Intelligence Studio.
 * Document Intelligence supports sophisticated analysis capabilities. The Studio allows one entry point (Analyze options button) for configuring the add-on capabilities with ease.
 * Depending on the document extraction scenario, configure the analysis range, document page range, optional detection, and premium detection features.
 
-    :::image type="content" source="media/studio/analyze-options.png" alt-text="Screenshot of the analyze options dialog window.":::
+    :::image type="content" source="media/studio/analyze-options.png" alt-text="Screenshot of the analyze-options dialog window.":::
 
     > [!NOTE]
     > Font extraction is not visualized in Document Intelligence Studio. However, you can check the styles section of the JSON output for the font detection results.
 
 ✔️ **Auto labeling documents with prebuilt models or one of your own models**
 
-* In custom extraction model labeling page, you can now auto label your documents using one of Document Intelligent Service prebuilt models or models you have trained before.
+* In custom extraction model labeling page, you can now auto label your documents using one of Document Intelligent Service prebuilt models or your trained models.
 
     :::image type="content" source="media/studio/auto-label.gif" alt-text="Animated screenshot showing auto labeling in Studio.":::
 
@@ -64,7 +64,7 @@ The following image shows the landing page for Document Intelligence Studio.
 
 ✔️ **Add test files directly to your training dataset**
 
-* Once you have trained a custom extraction model, make use of the test page to improve your model quality by uploading test documents to training dataset if needed.
+* Once you train a custom extraction model, make use of the test page to improve your model quality by uploading test documents to training dataset if needed.
 
 * If a low confidence score is returned for some labels, make sure they're correctly labeled. If not, add them to the training dataset and relabel to improve the model quality.
 
@@ -88,8 +88,6 @@ The following image shows the landing page for Document Intelligence Studio.
 
 * **Layout**: Try out Document Intelligence's Layout feature to extract text, tables, selection marks, and structure information. Start with the [Studio Layout feature](https://formrecognizer.appliedai.azure.com/studio/layout). Explore with sample documents and your documents. Use the interactive visualization and JSON output to understand how the feature works. See the [Layout overview](concept-layout.md) to learn more and get started with the [Python SDK quickstart for Layout](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-3.0.0&preserve-view=true#layout-model).
 
-* **General Documents**: Try out Document Intelligence's General Documents feature to extract key-value pairs. Start with the [Studio General Documents feature](https://formrecognizer.appliedai.azure.com/studio/document). Explore with sample documents and your documents. Use the interactive visualization and JSON output to understand how the feature works. See the [General Documents overview](concept-general-document.md) to learn more and get started with the [Python SDK quickstart for Layout](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-3.0.0&preserve-view=true#general-document-model).
-
 * **Prebuilt models**: Document Intelligence's prebuilt models enable you to add intelligent document processing to your apps and flows without having to train and build your own models. As an example, start with the [Studio Invoice feature](https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=invoice). Explore with sample documents and your documents. Use the interactive visualization, extracted fields list, and JSON output to understand how the feature works. See the [Models overview](concept-model-overview.md) to learn more and get started with the [Python SDK quickstart for Prebuilt Invoice](quickstarts/get-started-sdks-rest-api.md?view=doc-intel-3.0.0&preserve-view=true#prebuilt-model).
 
 * **Custom extraction models**: Document Intelligence's custom models enable you to extract fields and values from models trained with your data, tailored to your forms and documents. Create standalone custom models or combine two or more custom models to create a composed model to extract data from multiple form types. Start with the [Studio Custom models feature](https://formrecognizer.appliedai.azure.com/studio/custommodel/projects).  Use the help wizard, labeling interface, training step, and visualizations to understand how the feature works. Test the custom model with your sample documents and iterate to improve the model. See the [Custom models overview](concept-custom.md) to learn more.

articles/ai-services/document-intelligence/concept-query-fields.md

@@ -10,7 +10,7 @@ ms.custom:
 ms.topic: conceptual
 ms.date: 11/21/2023
 ms.author: nitinme
-monikerRange: 'doc-intel-3.0.0'
+monikerRange: 'doc-intel-4.0.0'
 ---
 
 <!-- markdownlint-disable MD033 -->

articles/ai-services/document-intelligence/index.yml

@@ -25,139 +25,103 @@ landingContent:
      linkLists:
       - linkListType: overview
         links:
-          - text: 🆕 What is Azure AI Document Intelligence?
+          - text: What is Azure AI Document Intelligence?
             url: overview.md
+          - text: Document Intelligence FAQ
+            url: faq.yml
       - linkListType: whats-new
         links:
           - text: What's new in Azure AI Document Intelligence?
             url: whats-new.md
       - linkListType: reference
         links:
-           - text: Language support
-             url: language-support.md
-           - text: 🆕 SDK overview v3.1 latest (GA)
+           - text: 🆕 SDK overview 2023-10-31-preview (preview)
+             url: sdk-overview-v4-0.md
+           - text: SDK overview 2023-07-31 latest (GA)
              url: sdk-overview-v3-1.md
-           - text: SDK overview v3.0 (GA)
+           - text: SDK overview 2022-08-31 legacy (GA)
              url: sdk-overview-v3-0.md
-           - text: Help and support
-             url: ../../ai-services/cognitive-services-support-options.md?context=/azure/ai-services/document-intelligence/context/context
 
-  #Card 2
-   - title: Azure AI Document Intelligence features
+#Card 2
+   - title: Document Intelligence Studio
+     linkLists:
+      - linkListType: overview
+        links:
+          - text: Studio overview
+            url: studio-overview.md
+          - text: Studio concepts
+            url: concept-document-intelligence-studio.md
+
+  #Card 3
+   - title: Document Intelligence models
+     linkLists:
+     - linkListType: architecture
+       links:
+         - text: Read
+           url: concept-read.md
+         - text: Layout
+           url: concept-layout.md
+         - text: Invoice
+           url: concept-invoice.md
+         - text: Receipt
+           url: concept-receipt.md
+         - text: ID document
+           url: concept-id-document.md
+         - text: Health insurance card
+           url: concept-health-insurance-card.md
+         - text: Contract
+           url: concept-contract.md
+         - text: US tax documents
+           url: concept-tax-document.md
+
+  #Card 4
+   - title: Document Intelligence concepts
      linkLists:
-         - linkListType: concept
-           links:
-             - text: Read model
-               url: concept-read.md
-             - text: General document model
-               url: concept-general-document.md
-             - text: Layout model
-               url: concept-layout.md
          - linkListType: concept
            links:
              - text: 🆕 Query field extraction
                url:  concept-query-fields.md
              - text: 🆕 Add-on capabilities
                url:  concept-add-on-capabilities.md
-             - text: 🆕 Health insurance card model
-               url:  concept-health-insurance-card.md
-             - text: Custom model
+             - text: 🆕 Retrieve-Augmented Generation (RAG)
+               url:  concept-retrieval-augumented-generation.md
+         - linkListType: concept
+           links:
+             - text: Pretrained model overview
+               url: concept-model-overview.md
+             - text: Accuracy and confidence scores
+               url: concept-accuracy-confidence.md
+             - text: "API response: analyze document"
+               url: concept-analyze-document-response.md
+             - text: Custom model overview
                url: concept-custom.md
-             - text: Tax document models
-               url: concept-tax-document.md
-             - text: Contract model
-               url: concept-contract.md
-             - text: Invoice model
-               url: concept-invoice.md
-             - text: Receipt model
-               url: concept-receipt.md
-             - text: ID document model
-               url: concept-id-document.md
-             - text: Business card model
-               url: concept-business-card.md
 
-  #Card 3
-   - title: Document Intelligence Studio 
-     linkLists:
-      - linkListType: overview
-        links:
-          - text: Studio overview
-            url: studio-overview.md
-      - linkListType: get-started
-        links:
-          - text: Read model
-            url: https://formrecognizer.appliedai.azure.com/studio/read
-          - text: General document model
-            url: https://formrecognizer.appliedai.azure.com/studio/document
-          - text:  Layout model
-            url: https://formrecognizer.appliedai.azure.com/studio/layout
-          - text:  Custom model
-            url: https://formrecognizer.appliedai.azure.com/studio/custommodel/projects
-          - text: 🆕 Health insurance card model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=healthInsuranceCard.us
-          - text: W2 model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=tax.us.w2
-          - text:  Invoice model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=invoice
-          - text:  Receipt model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=receipt
-          - text:  ID Document model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=idDocument
-          - text:  Business Card model
-            url: https://formrecognizer.appliedai.azure.com/studio/prebuilt?formType=businessCard
-  #Card 4
+
+  #Card 5
    - title: Quickstarts and how-to-guides
      linkLists:
       - linkListType: quickstart
         links:
         - text: Document Intelligence Studio
           url: quickstarts/try-document-intelligence-studio.md
         - text: Document Intelligence SDK
-          url: quickstarts/get-started-sdks-rest-api.md?view=doc-intel-3.0.0&preserve-view=true
+          url: quickstarts/get-started-sdks-rest-api.md
       - linkListType: how-to-guide
         links:
           - text: Create a Document Intelligence resource
             url: create-document-intelligence-resource.md
-          - text: Migrate to Document Intelligence v3.0
-            url: v3-1-migration-guide.md
-          - text: Use the read model
-            url: how-to-guides/use-sdk-rest-api.md?view=doc-intel-3.0.0&preserve-view=true
           - text: Create SAS tokens for storage containers
             url: create-sas-tokens.md
-          - text: Build a custom model (v3.0)
-            url:  how-to-guides/build-a-custom-model.md?view=doc-intel-3.0.0&preserve-view=true
-          - text: Compose custom models (v3.0)
-            url: how-to-guides/compose-custom-models.md?view=doc-intel-3.0.0&preserve-view=true
-          - text: Install and run Document Intelligence containers
-            url: containers/install-run.md
           - text: Create and use managed identities
             url: managed-identities.md
-
-  #Card 5
-   - title: Online presentations and community support
-     linkLists:
-      - linkListType: video
-        links:
-          - text: Analyze unstructured documents and more with Azure AI Document Intelligence
-            url: https://aka.ms/form-recognizer/ai-show
-          - text: Using AI With Documents - Syntax, AI Builder & Azure AI services
-            url: https://aka.ms/form-recognizer/event-session
-      - linkListType: reference
-        links:
-          - text: What's new in Document Intelligence - Semantic document segmentation, cross page tables and lots more
-            url: https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/what-s-new-in-form-recognizer-semantic-document-segmentation/ba-p/3468826
-          - text: Streamline insurance claim, patient check-in and more processes with Azure AI Document Intelligence
-            url:  https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/streamline-insurance-claim-patient-check-in-and-more-processes/ba-p/3419467
-          - text: Process large scale PDF or images to extract information forms using Azure AI Document Intelligence
-            url: https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/process-large-scale-pdf-or-images-to-extract-information-forms/ba-p/3481533
-          - text: Document Intelligence Solution Accelerator
-            url: https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/form-recognizer-solution-accelerator/ba-p/3262782
-          - text: Extracting information from unstructured document (for example, contracts) with Azure AI Document Intelligence
-            url:  https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/extracting-information-from-unstructured-document-e-g-contracts/ba-p/3267207
-          - text: Improve Customer Loyalty Program Automation with Azure AI Document Intelligence
-            url:  https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/improve-customer-loyalty-program-automation-with-azure-form/ba-p/3069233
-          - text: Extract values and line items from invoices with Document Intelligence now generally available
-            url:  https://techcommunity.microsoft.com/t5/ai-applied-ai-blog/extract-values-and-line-items-from-invoices-with-form-recognizer/ba-p/2414729
+          - text: Build a custom extraction model
+            url:  how-to-guides/build-a-custom-model.md
+          - text: Build a custom classification model
+            url:  how-to-guides/build-a-custom-classifier.md
+          - text: Compose custom models
+            url: how-to-guides/compose-custom-models.md
+          - text: Install and run Document Intelligence containers
+            url: containers/install-run.md
 
 # Card 6
    - title: Responsible AI