deboost legacy ocr

Author: PatrickFarley

articles/ai-services/computer-vision/index.yml

@@ -31,27 +31,6 @@ highlightedContent:
 
 conceptualContent:
   items:
-    - title: Optical character recognition
-      links:
-        - itemType: overview
-          text: About OCR
-          url: overview-ocr.md
-        - itemType: quickstart
-          text: Get started with OCR
-          url: quickstarts-sdk/client-library.md
-        - itemType: how-to-guide
-          text: Call the Read API
-          url: how-to/call-read-api.md
-        - itemType: deploy
-          text: Use the Read OCR container
-          url: computer-vision-how-to-install-containers.md
-        - itemType: learn
-          text: Microsoft Learn training
-          url: /training/modules/read-text-images-documents-with-computer-vision-service/
-        - itemType: reference
-          text: OCR API reference
-          url: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
-
     - title: Image Analysis
       links:
         - itemType: overview
@@ -118,6 +97,27 @@ conceptualContent:
         - itemType: how-to-guide
           text: Call the Video Retrieval APIs
           url: how-to/video-retrieval.md
+    - title: Optical character recognition (legacy)
+      links:
+        - itemType: overview
+          text: About OCR
+          url: overview-ocr.md
+        - itemType: quickstart
+          text: Get started with OCR
+          url: quickstarts-sdk/client-library.md
+        - itemType: how-to-guide
+          text: Call the Read API
+          url: how-to/call-read-api.md
+        - itemType: deploy
+          text: Use the Read OCR container
+          url: computer-vision-how-to-install-containers.md
+        - itemType: learn
+          text: Microsoft Learn training
+          url: /training/modules/read-text-images-documents-with-computer-vision-service/
+        - itemType: reference
+          text: OCR API reference
+          url: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
+
 
 tools:
   title: Software development kits (SDKs)

articles/ai-services/computer-vision/overview-ocr.md

@@ -15,6 +15,12 @@ ms.custom: devx-track-csharp
 
 # OCR - Optical Character Recognition
 
+> [!WARNING]
+> This service, including the Azure AI Vision legacy [OCR API in v3.2](/rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2) and [RecognizeText API in v2.1](/rest/api/computervision/recognize-printed-text/recognize-printed-text?view=rest-computervision-v2.1), is not recommended for use.
+
+[!INCLUDE [read-editions](includes/read-editions.md)]
+
+
 OCR or Optical Character Recognition is also referred to as text recognition or text extraction. Machine-learning-based OCR techniques allow you to extract printed or handwritten text from images such as posters, street signs and product labels, as well as from documents like articles, reports, forms, and invoices. The text is typically extracted as words, text lines, and paragraphs or text blocks, enabling access to digital version of the scanned text. This eliminates or significantly reduces the need for manual data entry.
 
 
@@ -23,10 +29,8 @@ OCR or Optical Character Recognition is also referred to as text recognition or
 
 Microsoft's **Read** OCR engine is composed of multiple advanced machine-learning based models supporting [global languages](./language-support.md). It can extract printed and handwritten text including mixed languages and writing styles. **Read** is available as cloud service and on-premises container for deployment flexibility. It's also available as a synchronous API for single, non-document, image-only scenarios with performance enhancements that make it easier to implement OCR-assisted user experiences.
 
-> [!WARNING]
-> The Azure AI Vision legacy [OCR API in v3.2](/rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2) and [RecognizeText API in v2.1](/rest/api/computervision/recognize-printed-text/recognize-printed-text?view=rest-computervision-v2.1) operations are not recommended for use.
 
-[!INCLUDE [read-editions](includes/read-editions.md)]
+
 
 ## How is OCR related to Intelligent Document Processing (IDP)?
 

articles/ai-services/computer-vision/toc.yml

@@ -22,78 +22,6 @@ items:
     href: use-case-alt-text.md
   - name: Verify a user
     href: use-case-identity-verification.md
-- name: Optical character recognition (OCR)
-  items:
-  - name: OCR overview
-    href: overview-ocr.md
-  - name: OCR quickstart
-    href: quickstarts-sdk/client-library.md
-  - name: Samples
-    href: /samples/browse/?products=azure&terms=computer-vision
-  - name: Responsible use of AI
-    items:
-    - name: Transparency notes
-      items:
-      - name: OCR use cases
-        href: /legal/cognitive-services/computer-vision/ocr-transparency-note?context=/azure/ai-services/computer-vision/context/context
-      - name: Characteristics and limitations
-        href: /legal/cognitive-services/computer-vision/ocr-characteristics-and-limitations?context=/azure/ai-services/computer-vision/context/context
-    - name: Integration and responsible use
-      href: /legal/cognitive-services/computer-vision/ocr-guidance-integration-responsible-use?context=/azure/ai-services/computer-vision/context/context
-    - name: Data, privacy, and security
-      href: /legal/cognitive-services/computer-vision/ocr-data-privacy-security?context=/azure/ai-services/computer-vision/context/context
-  - name: How-to guides
-    items:
-    - name: Call the Read API
-      href: how-to/call-read-api.md
-    - name: Upgrade from Read 2.x to Read 3.x
-      href: upgrade-api-versions.md
-    - name: Use the Read container
-      items:
-      - name: Install and run containers
-        href: computer-vision-how-to-install-containers.md
-        displayName: docker, container, package, packaged app, swagger, open api, openapi, train, publish, az, acr, cli, tps, core, curl, try it now, import, pull, on-premises
-      - name: Configure containers
-        href: computer-vision-resource-container-config.md
-      - name: Migrate to v3.x of the Read OCR container
-        href: read-container-migration-guide.md
-        displayName: docker, container, billing, apikey, pull, logging, on-premises
-      #- name: Use with Kubernetes and Helm
-      #  href: deploy-computer-vision-on-premises.md
-      #  displayName: kubectl, docker, helm, kubernetes, K8s, tiller, container, image, on-prem, on-premises
-      - name: Use container instances
-        maintainContext: true
-        href: ../containers/azure-container-instance-recipe.md
-        displayName: container instances, container, containers, images
-      - name: Use containers in disconnected environments
-        href: ../containers/disconnected-containers.md
-      - name: All Azure AI containers
-        href: ../cognitive-services-container-support.md
-        maintainContext: true
-  - name: Reference
-    items:
-    - name: OCR REST API v4.0 (preview)
-      href: https://aka.ms/vision-4-0-ref
-    - name: OCR REST API v3.2 
-      href: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
-    - name: OCR REST API v3.1
-      href: /rest/api/computervision/read?view=rest-computervision-v3.1
-    - name: OCR REST API v2.1
-      href: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v2.1
-    - name: .NET
-      href: /dotnet/api/overview/azure/computer-vision
-    - name: Node.js
-      href: /javascript/api/@azure/cognitiveservices-computervision/
-    - name: Python
-      href: /python/api/overview/azure/cognitiveservices-vision-computervision-readme
-    - name: Go
-      href: https://godoc.org/github.com/Azure/azure-sdk-for-go/services/cognitiveservices/v2.1/computervision
-    - name: Java
-      href: /java/api/overview/azure/cognitiveservices/client/computervision
-    - name: Azure CLI
-      href: /cli/azure/cognitiveservices#az_cognitiveservices_list
-    - name: Azure PowerShell
-      href: /powershell/module/az.cognitiveservices/
 - name: Image Analysis
   items:
   - name: Image Analysis overview
@@ -408,6 +336,79 @@ items:
     items:
     - name: Video Retrieval REST API
       href: reference-video-search.md
+- name: Optical character recognition (OCR) (legacy)
+  items:
+  - name: OCR overview
+    href: overview-ocr.md
+  - name: OCR quickstart
+    href: quickstarts-sdk/client-library.md
+  - name: Samples
+    href: /samples/browse/?products=azure&terms=computer-vision
+  - name: Responsible use of AI
+    items:
+    - name: Transparency notes
+      items:
+      - name: OCR use cases
+        href: /legal/cognitive-services/computer-vision/ocr-transparency-note?context=/azure/ai-services/computer-vision/context/context
+      - name: Characteristics and limitations
+        href: /legal/cognitive-services/computer-vision/ocr-characteristics-and-limitations?context=/azure/ai-services/computer-vision/context/context
+    - name: Integration and responsible use
+      href: /legal/cognitive-services/computer-vision/ocr-guidance-integration-responsible-use?context=/azure/ai-services/computer-vision/context/context
+    - name: Data, privacy, and security
+      href: /legal/cognitive-services/computer-vision/ocr-data-privacy-security?context=/azure/ai-services/computer-vision/context/context
+  - name: How-to guides
+    items:
+    - name: Call the Read API
+      href: how-to/call-read-api.md
+    - name: Upgrade from Read 2.x to Read 3.x
+      href: upgrade-api-versions.md
+    - name: Use the Read container
+      items:
+      - name: Install and run containers
+        href: computer-vision-how-to-install-containers.md
+        displayName: docker, container, package, packaged app, swagger, open api, openapi, train, publish, az, acr, cli, tps, core, curl, try it now, import, pull, on-premises
+      - name: Configure containers
+        href: computer-vision-resource-container-config.md
+      - name: Migrate to v3.x of the Read OCR container
+        href: read-container-migration-guide.md
+        displayName: docker, container, billing, apikey, pull, logging, on-premises
+      #- name: Use with Kubernetes and Helm
+      #  href: deploy-computer-vision-on-premises.md
+      #  displayName: kubectl, docker, helm, kubernetes, K8s, tiller, container, image, on-prem, on-premises
+      - name: Use container instances
+        maintainContext: true
+        href: ../containers/azure-container-instance-recipe.md
+        displayName: container instances, container, containers, images
+      - name: Use containers in disconnected environments
+        href: ../containers/disconnected-containers.md
+      - name: All Azure AI containers
+        href: ../cognitive-services-container-support.md
+        maintainContext: true
+  - name: Reference
+    items:
+    - name: OCR REST API v4.0 (preview)
+      href: https://aka.ms/vision-4-0-ref
+    - name: OCR REST API v3.2 
+      href: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
+    - name: OCR REST API v3.1
+      href: /rest/api/computervision/read?view=rest-computervision-v3.1
+    - name: OCR REST API v2.1
+      href: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v2.1
+    - name: .NET
+      href: /dotnet/api/overview/azure/computer-vision
+    - name: Node.js
+      href: /javascript/api/@azure/cognitiveservices-computervision/
+    - name: Python
+      href: /python/api/overview/azure/cognitiveservices-vision-computervision-readme
+    - name: Go
+      href: https://godoc.org/github.com/Azure/azure-sdk-for-go/services/cognitiveservices/v2.1/computervision
+    - name: Java
+      href: /java/api/overview/azure/cognitiveservices/client/computervision
+    - name: Azure CLI
+      href: /cli/azure/cognitiveservices#az_cognitiveservices_list
+    - name: Azure PowerShell
+      href: /powershell/module/az.cognitiveservices/
+
 - name: How-to guides
   items:
   - name: Enterprise readiness