plan DI freshness review

ivorb · ivorb · commit 818b837d8960 · 2025-05-01T09:43:35.000-04:00
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/1-introduction.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/1-introduction.yml
@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.introduction
-title: Introduction
-metadata:
-  title: Introduction
-  description: Introduction
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 2
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Introduction
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 2
+content: |
+  [!include[](includes/1-introduction.md)]
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/2-understand.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/2-understand.yml
@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.understand
-title: Understand AI Document Intelligence
-metadata:
-  title: Understand AI Document Intelligence
-  description: Understand AI Document Intelligence
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 10
-content: |
-  [!include[](includes/2-understand.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.understand
+title: Understand AI Document Intelligence
+metadata:
+  title: Understand AI Document Intelligence
+  description: Understand AI Document Intelligence
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 10
+content: |
+  [!include[](includes/2-understand.md)]
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/3-resources.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/3-resources.yml
@@ -1,20 +1,20 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.resources
-title: Plan Azure AI Document Intelligence resources
-metadata:
-  title: Plan Azure AI Document Intelligence resources
-  description: Plan Azure AI Document Intelligence resources
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-  ms.custom: devx-track-python
-  zone_pivot_groups: dev-lang-csharp-python
-azureSandbox: false
-labModal: false
-durationInMinutes: 4
-content: |
-  [!include[](includes/3-resources.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.resources
+title: Plan Azure AI Document Intelligence resources
+metadata:
+  title: Plan Azure AI Document Intelligence resources
+  description: Plan Azure AI Document Intelligence resources
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+  ms.custom: devx-track-python
+  zone_pivot_groups: dev-lang-csharp-python
+azureSandbox: false
+labModal: false
+durationInMinutes: 4
+content: |
+  [!include[](includes/3-resources.md)]
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/4-choose-model-type.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/4-choose-model-type.yml
@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.choose-model-type
-title: Choose a model type
-metadata:
-  title: Choose a model type
-  description: Choose a model type
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 7
-content: |
-  [!include[](includes/4-choose-model-type.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.choose-model-type
+title: Choose a model type
+metadata:
+  title: Choose a model type
+  description: Choose a model type
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 7
+content: |
+  [!include[](includes/4-choose-model-type.md)]
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/5-knowledge-check.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/5-knowledge-check.yml
@@ -1,65 +1,65 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.knowledge-check
-title: Module assessment
-metadata:
-  title: Module assessment
-  description: Knowledge check
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 10
-content: |
-  [!include[](includes/5-knowledge-check.md)]
-quiz:
-  title: "Check your knowledge"
-  questions:
-  - content: "You want to create an Azure AI Document Intelligence model where the documents are in one of three formats: wills, probate declarations, and affidavits. Each has their own specific layout. What type of model should you use that will understand the format of the three document categories?"
-    choices:
-    - content: "A Read model."
-      isCorrect: false
-      explanation: "Incorrect. A Read model obtains text and key-value pairs from the legal documents but won't categorize them."
-    - content: "A Layout model."
-      isCorrect: false
-      explanation: "Incorrect. A Layout model obtains structure information, select marks, and other information from the legal forms, but won't categorize them"
-    - content: "A Composed model."
-      isCorrect: true
-      explanation: "Correct. A Composed model consists of multiple custom models. Each submitted form is categorized as one of the custom form types and analyzed using the corresponding custom model."
-  - content: "You have developed a custom model that analyzes health assessment forms returned by patients to a medical practice. You've observed too much inaccuracy in the values that the model extracts for each field. What should you do to address this problem?"
-    choices:
-    - content: "Retrain the model with a larger number of example forms."
-      isCorrect: true
-      explanation: "Correct. The larger the number of example forms you use to train a model, the more accurate it will be and the higher the confidence levels will be."
-    - content: "Change from a custom model to the general document model."
-      isCorrect: false
-      explanation: "Incorrect. The general document model won't help to improve field value extraction for specific document types."
-    - content: "Change from the free tier to the standard tier."
-      isCorrect: false
-      explanation: "Incorrect. The tier you use for your Azure AI Document Intelligence resource doesn't affect the accuracy of field value extraction."
-  - content: "You want to call your Azure AI Document Intelligence solution from a mobile app by using an API. Which of the following programming languages is natively supported as an Azure AI Document Intelligence SDK?"
-    choices:
-    - content: "Python"
-      isCorrect: true
-      explanation: "Correct. Microsoft publishes a Python API you can use to call Azure AI Document Intelligence services."
-    - content: "Go"
-      isCorrect: false
-      explanation: "Incorrect. There's no Azure AI Document Intelligence API for Go, but you can submit requests through the RESTful web service."
-    - content: "R"
-      isCorrect: false
-      explanation: "Incorrect. There's no Azure AI Document Intelligence API for R, but you can submit requests through the RESTful web service."
-  - content: "Which of the following is an Azure AI Document Intelligence prebuilt model?"
-    choices:
-    - content: "Employment record"
-      isCorrect: false
-      explanation: "Incorrect. There's no employment record prebuilt model in Azure AI Document Intelligence although you can analyze scanned employment records and extract text, key/values pairs, and other information"
-    - content: "Resume"
-      isCorrect: false
-      explanation: "Incorrect. There's no resume prebuilt model in Azure AI Document Intelligence although you can analyze scanned resumes and extract text, key/values pairs, and other information."
-    - content: "Receipt"
-      isCorrect: true
-      explanation: "Correct. The receipt model can identify commonly used fields and their values in scanned or photographed receipt documents."
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.knowledge-check
+title: Module assessment
+metadata:
+  title: Module assessment
+  description: Knowledge check
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 10
+content: |
+  [!include[](includes/5-knowledge-check.md)]
+quiz:
+  title: "Check your knowledge"
+  questions:
+  - content: "You want to create an Azure AI Document Intelligence model where the documents are in one of three formats: wills, probate declarations, and affidavits. Each has their own specific layout. What type of model should you use that will understand the format of the three document categories?"
+    choices:
+    - content: "A Read model."
+      isCorrect: false
+      explanation: "Incorrect. A Read model obtains text and key-value pairs from the legal documents but won't categorize them."
+    - content: "A Layout model."
+      isCorrect: false
+      explanation: "Incorrect. A Layout model obtains structure information, select marks, and other information from the legal forms, but won't categorize them"
+    - content: "A Composed model."
+      isCorrect: true
+      explanation: "Correct. A Composed model consists of multiple custom models. Each submitted form is categorized as one of the custom form types and analyzed using the corresponding custom model."
+  - content: "You have developed a custom model that analyzes health assessment forms returned by patients to a medical practice. You've observed too much inaccuracy in the values that the model extracts for each field. What should you do to address this problem?"
+    choices:
+    - content: "Retrain the model with a larger number of example forms."
+      isCorrect: true
+      explanation: "Correct. The larger the number of example forms you use to train a model, the more accurate it will be and the higher the confidence levels will be."
+    - content: "Change from a custom model to the general document model."
+      isCorrect: false
+      explanation: "Incorrect. The general document model won't help to improve field value extraction for specific document types."
+    - content: "Change from the free tier to the standard tier."
+      isCorrect: false
+      explanation: "Incorrect. The tier you use for your Azure AI Document Intelligence resource doesn't affect the accuracy of field value extraction."
+  - content: "You want to call your Azure AI Document Intelligence solution from a mobile app by using an API. Which of the following programming languages is natively supported as an Azure AI Document Intelligence SDK?"
+    choices:
+    - content: "`Python`"
+      isCorrect: true
+      explanation: "Correct. Microsoft publishes a Python API you can use to call Azure AI Document Intelligence services."
+    - content: "`Go`"
+      isCorrect: false
+      explanation: "Incorrect. There's no Azure AI Document Intelligence API for Go, but you can submit requests through the RESTful web service."
+    - content: "`R`"
+      isCorrect: false
+      explanation: "Incorrect. There's no Azure AI Document Intelligence API for R, but you can submit requests through the RESTful web service."
+  - content: "Which of the following is an Azure AI Document Intelligence prebuilt model?"
+    choices:
+    - content: "Employment record"
+      isCorrect: false
+      explanation: "Incorrect. There's no employment record prebuilt model in Azure AI Document Intelligence although you can analyze scanned employment records and extract text, key/values pairs, and other information"
+    - content: "Resume"
+      isCorrect: false
+      explanation: "Incorrect. There's no resume prebuilt model in Azure AI Document Intelligence although you can analyze scanned resumes and extract text, key/values pairs, and other information."
+    - content: "Receipt"
+      isCorrect: true
+      explanation: "Correct. The receipt model can identify commonly used fields and their values in scanned or photographed receipt documents."
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/6-summary.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/6-summary.yml
@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.wwl.plan-form-recognizer-solution.summary
-title: Summary
-metadata:
-  title: Summary
-  description: Summary
-  author: ivorb
-  ms.author: berryivor
-  ms.date: 09/04/2024
-  ms.topic: unit
-  ms.collection:
-    - wwl-ai-copilot
-azureSandbox: false
-labModal: false
-durationInMinutes: 2
-content: |
-  [!include[](includes/6-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.wwl.plan-form-recognizer-solution.summary
+title: Summary
+metadata:
+  title: Summary
+  description: Summary
+  author: ivorb
+  ms.author: berryivor
+  ms.date: 5/01/2025
+  ms.topic: unit
+  ms.collection:
+    - wwl-ai-copilot
+azureSandbox: false
+labModal: false
+durationInMinutes: 2
+content: |
+  [!include[](includes/6-summary.md)]
+
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/includes/2-understand.md b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/includes/2-understand.md
@@ -33,13 +33,12 @@ Use a model to inform Azure AI Document Intelligence about the type of data you
 
 Azure AI Document Intelligence includes several prebuilt models for common types of forms and documents. If your forms are of one of these types, you can extract information from them without training your own custom models. It's very quick to create and deploy an Azure AI Document Intelligence solution when you use prebuilt models.
 
-In Azure AI Document Intelligence, three of the prebuilt models are for general document analysis:
+In Azure AI Document Intelligence, there are prebuilt models are for general document analysis:
 
 - Read
-- General document
 - Layout
 
-The other prebuilt models expect a common type of form or document:
+The other prebuilt models expect a common type of form or document, such as:
 
 - Invoice
 - Receipt
@@ -49,7 +48,7 @@ The other prebuilt models expect a common type of form or document:
 - Health insurance card
 
 > [!IMPORTANT]
-> This list shows the documented prebuilt models avaiable at the time of writing. More prebuilt models are in development will be deployed soon. Check the Azure AI Document Intelligence documentation for the latest models.
+> This list shows a subset of the prebuilt models available. Check the Azure AI Document Intelligence documentation for [all available models](/azure/ai-services/document-intelligence/model-overview?view=doc-intel-4.0.0&azure-portal=true#model-overview).
 
 If you have an unusual or unique type of form, you can use the above general document analysis prebuilt models to extract information from them. However, if you want to extract more specific information than the prebuilt models support, you can create a **custom model** and train it by using examples of completed forms. 
 
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/includes/4-choose-model-type.md b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/includes/4-choose-model-type.md
@@ -16,7 +16,7 @@ Three of the prebuilt models are designed to handle general documents and extrac
 
     :::image type="content" source="../media/04-read-model.png" alt-text="Screenshot showing the read model analyzing a document in German in Azure AI Document Intelligence Studio." lightbox="../media/04-read-model.png":::
 
-- **General document.** Use this model to extract key-value pairs and tables in your documents.
+- **General document.** _Deprecated in v4_. Use this model to extract key-value pairs and tables in your documents.
 
     :::image type="content" source="../media/04-general-document-model.png" alt-text="Screenshot showing the general document model analyzing a document in Azure AI Document Intelligence Studio." lightbox="../media/04-general-document-model.png":::
  
diff --git a/learn-pr/wwl-data-ai/plan-form-recognizer-solution/index.yml b/learn-pr/wwl-data-ai/plan-form-recognizer-solution/index.yml
