Merge pull request #215468 from laujan/214995-vinod-migration

214995 vinod migration

Author: Stacyrch140

articles/applied-ai-services/form-recognizer/v3-migration-guide.md

@@ -19,6 +19,20 @@ recommendations: false
 >
 > Form Recognizer REST API v3.0 introduces breaking changes in the REST API request and analyze response JSON.
 
+## Migrating from a v3.0 preview API version
+
+Preview APIs are periodically deprecated. If you're using a preview API version, plan on updating your application to target the GA API version once available. To migrate from the 2021-09-30-preview or the 2022-01-30-preview API versions to the 2022-08-31 (GA) API version using the SDK, update to the [current version of the language specific SDK](sdk-overview.md).
+
+The 2022-08-31 API has a few updates from the preview API versions:
+* Field rename:  boundingBox to polygon to support non-quadrilateral polygon regions.
+* Field deleted: entities removed from the result of the general document model.
+* Field rename: documentLanguage.languageCode to locale
+* Added support for HEIF format
+* Added paragraph detection, with role classification for layout and general document models
+* Added support for parsed address fields.
+
+## Migrating from v2.1
+
 Form Recognizer v3.0  introduces several new features and capabilities:
 
 * [Form Recognizer REST API](quickstarts/get-started-sdks-rest-api.md?view=form-recog-3.0.0&preserve-view=true) has been redesigned for better usability.
@@ -92,7 +106,7 @@ Base64 encoding is also supported in Form Recognizer v3.0:
 }
 ```
 
-### Additional supported parameters
+### Additionally supported parameters
 
 Parameters that continue to be supported:
 
@@ -372,4 +386,5 @@ In this migration guide, you've learned how to upgrade your existing Form Recogn
 
 * [Review the new REST API](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/AnalyzeDocument)
 * [What is Form Recognizer?](overview.md)
-* [Form Recognizer quickstart](/azure/applied-ai-services/form-recognizer/how-to-guides/v2-1-sdk-rest-api)
+* [Form Recognizer quickstart](./quickstarts/try-sdk-rest-api.md)
+

articles/applied-ai-services/form-recognizer/whats-new.md

@@ -11,6 +11,7 @@ ms.date: 10/20/2022
 ms.author: lajanuar
 monikerRange: '>=form-recog-2.1.0'
 recommendations: false
+ms.custom: references_regions
 ---
 <!-- markdownlint-disable MD024 -->
 <!-- markdownlint-disable MD036 -->
@@ -23,12 +24,22 @@ recommendations: false
 
 Form Recognizer service is updated on an ongoing basis. Bookmark this page to stay up to date with release notes, feature enhancements, and documentation updates.
 
+>[!NOTE]
+> With the release of the 2022-08-31 GA API, the associated preview APIs are being deprecated. If you are using the 2021-09-30-preview or the 2022-01-30-preview API versions, please update your applications to target the 2022-08-31 API version. There are a few minor changes involved, for more information, _see_ the [migration guide](v3-migration-guide.md).
+
 ## October 2022
 
 With the latest preview release, Form Recognizer's Read (OCR), Layout, and Custom template models support 134 new languages. These language additions include Greek, Latvian, Serbian, Thai, Ukrainian, and Vietnamese, along with several Latin and Cyrillic languages. Form Recognizer now has a total of 299 supported languages across the most recent GA and new preview versions. Refer to the [supported languages](language-support.md) page to see all supported languages.
 
 Use the REST API parameter `api-version=2022-06-30-preview` when using the API or the corresponding SDK to support the new languages in your applications.
 
+### Region expansion for training custom neural models 
+
+Training custom neural models now supported in added regions.
+* East US
+* East US2
+* US Gov Arizona
+
 ## September 2022
 
 ### Region expansion for training custom neural models
@@ -565,7 +576,7 @@ The updated Layout API table feature adds header recognition with column headers
 
 * Client defaults to the latest supported service version, currently v2.1. You can specify version 2.0  in the **FormRecognizerClientOptions** object's **Version** property.
 
-* **StartRecognizeIdentityDocuments**. Renamed methods and method parameters using **Identity** to replace _Id_ keyword for all related identity documents recognition API functionalities.
+* **StartRecognizeIdentityDocuments**. Renamed methods and method parameters using **Identity** to replace _ID_ keyword for all related identity documents recognition API functionalities.
 
 * **FormReadingOrder**. *ReadingOrder* renamed to **FormReadingOrder**.
 
@@ -653,7 +664,7 @@ The updated Layout API table feature adds header recognition with column headers
 
 #### **Breaking changes (May)**
 
-* **begin_recognize_identity_documents** and **begin_recognize_identity_documents_from_url**. Renamed methods and method parameters using **Identity** to replace _Id_ keyword.
+* **begin_recognize_identity_documents** and **begin_recognize_identity_documents_from_url**. Renamed methods and method parameters using **Identity** to replace _ID_ keyword.
 
 * **FieldValueType**. Renamed value type *country* to **countryRegion**.  Removed value type *gender*.