writer edits

Author: PatrickFarley

articles/ai-services/computer-vision/migration-optionss.md renamed to articles/ai-services/computer-vision/migration-options.md

@@ -1,37 +1,50 @@
-# Migration Guidance for Transitioning from Computer Vision - Image Analysis
+---
+title: Migrate from Azure AI Vision - Image Analysis
+description: Guidance for migrating from Azure Computer Vision - Image Analysis API to alternative solutions before its retirement in September 2028.
+author: pafarley
+ms.author: pafarley
+ms.date: 09/24/2025
+ms.topic: article
+ms.service: cognitive-services
+ms.subservice: computer-vision
+ms.custom: ai-migration, vision
+---
 
-The Azure Computer Vision - Image Analysis API will be retired on September 25, 2028, after which calls made to the service will fail. Microsoft will provide full support for all existing Image Analysis customers until 9/25/2028, but to ensure business continuity and minimize disruption, customers are encouraged to begin planning their migration to alternative solutions that best meet their scenario requirements. This document provides comprehensive guidance for evaluating, selecting, and transitioning to new services.
+# Migrate from Azure AI Vision - Image Analysis
+
+The Azure AI Vision - Image Analysis API will be retired on September 25, 2028, after which calls made to the service will fail. Microsoft will provide full support for all existing Image Analysis customers until 9/25/2028, but to ensure business continuity and minimize disruption, we encourage customers to begin planning their migration to alternative solutions that best meet their scenario requirements. This document provides comprehensive guidance for evaluating, selecting, and transitioning to new services.
+
+## Migration preparation checklist
 
-## Migration Preparation Checklist
 1.	Assess current usage and dependencies on Image Analysis API.
 2.	Identify business scenarios and technical requirements for your image analysis scenarios.
 3.	Evaluate alternative solutions based on capabilities, integration, cost, and support.
 4.	Plan model migration steps.
 5.	Test new solution(s) in a staging environment.
 6.	Update production workflows and retrain stakeholders.
 
-## Alternative Options Based on Scenario Needs
+## Alternative options based on scenario needs
 There are several alternative platforms and services that can be considered depending on your specific use case, technical requirements, and integration needs. The following options are recommended for each set of features under Image Analysis.
 
-### For OCR and Read capabilities try Document Intelligence
+### For OCR and Read capabilities, try Document Intelligence
 
 The Document Intelligence service provides support for OCR text in images.
 * **Features**: Azure AI Document Intelligence is a cloud-based Azure AI service that you can use to build intelligent document processing solutions.
 * **Learn more** about Document Intelligence:
     * [What is Azure AI Document Intelligence?]()
     * [Document Intelligence Read model]()
 
-### For Face scenarios: try the Face API
+### For Face scenarios, try the Face API
 
 The Face service offers Face detection capabilities, as well as a more comprehensive portfolio of face-related features. 
 * **Features**: Full support for all Face scenarios under the Image Analysis API.
 * **Learn more** about the Face API:
     * [What is the Azure AI Face Service?]()
     * [Face detection, attributes, and input data]()
 
-### For image embeddings scenarios:
+### Image embeddings scenarios:
 
-#### Cohere Embed v3 in the Azure AI Foundry
+#### Cohere Embed v3 in Azure AI Foundry
 * **Best for**: Customers who need image + text embeddings supported on Azure.
 * **Features**: A multilingual multimodal embedding model supported in the Azure AI Foundry portal. It is capable of transforming different modalities such as images, texts, and interleaved images and texts into a single vector representation.
 * **Learn more** about Cohere Embed v4:
@@ -44,11 +57,11 @@ The Face service offers Face detection capabilities, as well as a more comprehen
     * [Sigmoid Loss for Language Image Pre-Training]()
     * [SigLP on Hugging Face]()
 
-### For other Computer Vision scenarios:
+### Other AI Vision scenarios
 
 There are multiple additional alternative services that can support the remaining scenarios supported in the Image Analysis API. 
 
-#### GPT Model Series in the Azure AI Foundry
+#### GPT model series in the Azure AI Foundry
 
 * **Best for**: Customers who are flexible in their approach to creating a solution for customized vision capabilities.
 * **Features**: Flexibility to build custom solutions based on different Generative AI models.
@@ -64,7 +77,6 @@ There are multiple additional alternative services that can support the remainin
     * [Azure AI Content Understanding image solutions (preview)]()
     * [Content Understanding classifier]()
 
-## Next steps & required actions
-* Make a plan to transition away from Azure Computer Vision – Image Analysis by September 25, 2026
-* Azure Computer Vision – Image Analysis will be retired on 25 September 2028, please transition to alternative options by that date
-
+## Next steps and required actions
+* Make a plan to transition away from Azure Computer Vision – Image Analysis by September 25, 2026.
+* Azure Computer Vision – Image Analysis will be retired on 25 September 2028, please transition to alternative options by that date.

articles/ai-services/custom-vision-service/includes/custom-vision-retirement.md

@@ -4,9 +4,8 @@ titleSuffix: Azure AI services
 author: PatrickFarley
 manager: nitinme
 ms.service: azure-ai-custom-vision
-ms.custom: build-2023
 ms.topic: include
-ms.date: 09/04/2025
+ms.date: 09/24/2025
 ms.author: pafarley
 ---
 
@@ -22,4 +21,4 @@ ms.author: pafarley
 > - For a managed generative solution for image classification, Azure AI Content Understanding (currently in public preview) offers the ability to create custom classification workflows. It also supports processing unstructured data of any type (image, documents, audio, video) and extract structured insights based on pre-defined or user-defined formats.
 > - [Learn more about Azure AI Foundry Models]() and [Azure AI Content Understanding (public preview)]() and explore how they can offer alternative paths for your custom needs.
 >
-> For more detailed guidance on migration, see the (Azure Custom Vision Migration Guide)[https://aka.ms/custom-vision-migration].
+> For more detailed guidance on migration, see the [Azure Custom Vision Migration Guide](https://aka.ms/custom-vision-migration).

articles/ai-services/custom-vision-service/migration-options.md

@@ -1,4 +1,15 @@
-# Migration Guidance for Transitioning from Custom Vision Service
+---
+title: Migrate from Custom Vision Service
+description: Guidance for migrating from Azure Custom Vision Service to alternative solutions before its retirement in September 2028.
+author: pafarley
+ms.author: pafarley
+ms.date: 09/24/2025
+ms.topic: how-to
+ms.service: azure-ai-custom-vision
+ms.custom: ai-migration, vision
+---
+
+# Migrate from Custom Vision Service
 
 The Custom Vision Service will be retired on September 25, 2028, after which calls made to the service will fail. Microsoft will provide full support for all existing Azure Custom Vision customers until 9/25/2028, but to ensure business continuity and minimize disruption, customers are encouraged to begin planning their migration to alternative solutions that best meet their scenario requirements. This document provides comprehensive guidance for evaluating, selecting, and transitioning to new services.
 
@@ -11,13 +22,13 @@ The Custom Vision Service will be retired on September 25, 2028, after which cal
 5.	Test new solution(s) in a staging environment.
 6.	Update production workflows and retrain stakeholders.
 
-## Alternative Options Based on Scenario Needs
-There are several alternative platforms and services that can be considered depending on your specific use case, technical requirements, and integration needs. The following options are recommended for common scenarios:
+## Alternative options based on scenario needs
+There are several alternative platforms and services you can consider depending on your specific use case, technical requirements, and integration needs. We recommended the following options for common scenarios:
 
-### Traditional Machine Learning options
-To create both custom image classification and object detection models using traditional machine learning techniques, take a look at the following option:
+### Traditional machine learning options
+
+To create both custom image classification and object detection models using traditional machine learning techniques, consider Azure Machine Learning with AutoML.
 
-#### Azure Machine Learning AutoML
 * **Best for**: Customers seeking to apply classic machine learning techniques
 * **Features**: Offers a code-first experience, as well as a no-code studio web experience similar to Custom Vision. It offers the ability to easily train custom image classification and object detection models on your image data.
 * **Learn more** about Azure Machine Learning AutoML:
@@ -28,7 +39,7 @@ To create both custom image classification and object detection models using tra
 ### Generative AI-based solutions
 Microsoft is also investing in Generative AI-based solutions that increase accuracy in custom scenarios using prompt engineering and other techniques.
 
-#### Generative AI solutions in the Azure AI Foundry
+#### Generative AI solutions in Azure AI Foundry
 
 * **Best for**: Customers who are flexible in their approach to creating a solution for customized vision capabilities.
 *	**Features**: Flexibility to build custom solutions based on different Generative AI models.
@@ -37,16 +48,16 @@ Microsoft is also investing in Generative AI-based solutions that increase accur
     *	[Azure OpenAI in Azure AI Foundry models]()
 
 #### Azure AI Content Understanding (preview)
-* **Best for**: Customers wanting a managed generative solution for image classification
+* **Best for**: Customers who want a managed generative solution for image classification
 * **Features**: Content Understanding offers the ability to create custom classification workflows. It also supports processing unstructured data of any type (image, documents, audio, video) and extracting structured insights based on pre-defined or user-defined formats.
 * **Learn more** about Content Understanding:
     * [What is Azure AI Content Understanding?]()
     * [Azure AI Content Understanding image solutions (preview)]()
     * [Content Understanding classifier]()
 
-## Data Migration Guidance
-Before migrating, export your labeled datasets and model metadata from Custom Vision Service. Review the data formats required by your chosen alternative and convert as needed.
+## Data migration guidance
+Before you migrate services, export your labeled datasets and model metadata from Custom Vision Service. Review the data formats required by your chosen alternative and convert as needed.
 
-## Next steps & required actions
-* Make a plan to transition away from Azure Custom Vision by September 25, 2026
+## Next steps and required actions
+* Make a plan to transition away from Azure Custom Vision by September 25, 2026.
 * Azure Custom Vision will be retired on 25 September 2028, please transition to alternative options by that date.