Merge pull request #218619 from laujan/36568-metrics-depreciation-product-update

add deprecation page

Author: AnnaMHuff

articles/cognitive-services/Translator/modifications-deprecations.md

@@ -0,0 +1,39 @@
+---
+title: Modifications to Translator Service
+description: Translator Service changes, modifications, and deprecations
+services: cognitive-services
+author: laujan
+manager: nitinme
+ms.service: cognitive-services
+ms.topic: reference
+ms.subservice: translator-text
+ms.date: 11/15/2022
+ms.author: lajanuar
+---
+
+# Modifications to Translator Service
+
+Learn about Translator service changes, modification, and deprecations.
+
+> [!NOTE]
+> Looking for updates and preview announcements? Visit our [What's new](whats-new.md) page to stay up to date with release notes, feature enhancements, and our newest documentation.
+
+## November 2022
+
+### Changes to Translator `Usage` metrics
+
+> [!IMPORTANT]
+> **`Characters Translated`** and **`Characters Trained`** metrics are deprecated and have been removed from the Azure portal.
+
+|Deprecated metric| Current metric(s) | Description|
+|---|---|---|
+|Characters Translated (Deprecated)</br></br></br></br>|**&bullet; Text Characters Translated**</br></br>**&bullet;Text Custom Characters Translated**| &bullet; Number of characters in incoming **text** translation request.</br></br> &bullet; Number of characters in incoming **custom** translation request.  |
+|Characters Trained (Deprecated) | **&bullet; Text Trained Characters** | &bullet; Number of characters **trained** using text translation service.|
+
+* In 2021, two new metrics, **Text Characters Translated** and **Text Custom Characters Translated**, were added to help with granular metrics data service usage. These metrics replaced **Characters Translated** which provided combined usage data for the general and custom text translation service.
+
+* Similarly, the **Text Trained Characters** metric was added to replace the  **Characters Trained** metric.
+
+* **Characters Trained** and **Characters Translated** metrics have had continued support in the Azure portal with the deprecated flag to allow migration to the current metrics. As of October 2022, Characters Trained and Characters Translated are no longer available in the Azure portal.
+
+---

articles/cognitive-services/Translator/toc.yml

@@ -241,6 +241,9 @@ items:
     href: custom-translator/faq.md
 - name: Resources
   items:
+  - name: Modifications to Translator Service
+    displayName: deprecation, deprecate, changes, modify, modifications
+    href: modifications-deprecations.md
   - name: Translator in sovereign clouds
     displayName: fairfax,compliant,secret,compliance,government,government cloud,dod,china,batch,region
     href: sovereign-clouds.md

articles/cognitive-services/Translator/translator-overview.md

@@ -8,15 +8,13 @@ manager: nitinme
 ms.service: cognitive-services
 ms.topic: overview
 ms.subservice: translator-text
-ms.date: 07/11/2022
+ms.date: 11/16/2022
 ms.author: lajanuar
-ms.custom: cog-serv-seo-aug-2020
-keywords: translator, text translation, machine translation, translation service, custom translator
 ---
 
 # What is Azure Cognitive Services Translator?
 
-Translator Service is a cloud-based neural machine translation service that is part of the [Azure Cognitive Services](../what-are-cognitive-services.md) family of REST APIs.  Translator can be used with any operating system and powers many Microsoft products and services used by thousands of businesses worldwide to perform language translation and other language-related operations. In this overview, you'll learn how Translator can enable you to build intelligent, multi-language solutions for your applications across all [supported languages](./language-support.md).
+Translator Service is a cloud-based neural machine translation service that is part of the [Azure Cognitive Services](../what-are-cognitive-services.md) family of REST APIs and can be used with any operating system. Translator powers many Microsoft products and services used by thousands of businesses worldwide to perform language translation and other language-related operations. In this overview, you'll learn how Translator can enable you to build intelligent, multi-language solutions for your applications across all [supported languages](./language-support.md).
 
 Translator documentation contains the following article types:
 

articles/cognitive-services/Translator/whats-new.md

@@ -8,7 +8,7 @@ ms.service: cognitive-services
 ms.subservice: translator-text
 ms.custom: event-tier1-build-2022
 ms.topic: overview
-ms.date: 06/14/2022
+ms.date: 11/16/2022
 ms.author: lajanuar
 ---
 <!-- markdownlint-disable MD024 -->
@@ -17,7 +17,7 @@ ms.author: lajanuar
 
 # What's new in Azure Cognitive Services Translator?
 
-Bookmark this page to stay up to date with release notes, feature enhancements, and documentation updates.
+Bookmark this page to stay up to date with release notes, feature enhancements, and our newest documentation.
 
 Translator is a language service that enables users to translate text and documents, helps entities expand their global outreach, and supports preservation of at-risk and endangered languages.