Merge pull request #234734 from laujan/70203-move-content-limits-section-visibility

move and update content limits

Author: Court72

articles/cognitive-services/Translator/document-translation/how-to-guides/use-rest-api-programmatically.md

@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: quickstart
-ms.date: 03/22/2023
+ms.date: 04/17/2023
 ms.author: lajanuar
 recommendations: false
 ms.devlang: csharp, golang, java, javascript, python
@@ -112,6 +112,8 @@ The `sourceUrl` , `targetUrl` , and optional `glossaryUrl`  must include a Share
 
 A batch Document Translation request is submitted to your Translator service endpoint via a POST request. If successful, the POST method returns a `202 Accepted`  response code and the service creates a batch request. The translated documents are listed in your target container.
 
+For detailed information regarding Azure Translator Service request limits, _see_ [**Document Translation request limits**](../../request-limits.md#document-translation).
+
 ### HTTP headers
 
 The following headers are included with each Document Translation API request:
@@ -1272,22 +1274,6 @@ func main() {
 
 ---
 
-## Content limits
-
-This table lists the limits for data that you send to Document Translation:
-
-|Attribute | Limit|
-|---|---|
-|Document size| ≤ 40 MB |
-|Total number of files.|≤ 1000 |
-|Total content size in a batch | ≤ 250 MB|
-|Number of target languages in a batch| ≤ 10 |
-|Size of Translation memory file| ≤ 10 MB|
-
-Document Translation can't be used to translate secured documents such as those with an encrypted password or with restricted access to copy content.
-
-## Troubleshooting
-
 ### Common HTTP status codes
 
 | HTTP status code | Description | Possible reason |
@@ -1307,5 +1293,3 @@ Document Translation can't be used to translate secured documents such as those
 
 > [!div class="nextstepaction"]
 > [Create a customized language system using Custom Translator](../../custom-translator/overview.md)
->
->

articles/cognitive-services/Translator/document-translation/overview.md

@@ -8,7 +8,7 @@ ms.service: cognitive-services
 ms.subservice: translator-text
 ms.custom: event-tier1-build-2022
 ms.topic: overview
-ms.date: 03/24/2023
+ms.date: 04/17/2023
 ms.author: lajanuar
 recommendations: false
 ---
@@ -30,7 +30,7 @@ Document Translation is a cloud-based feature of the [Azure Translator](../trans
 
 > [!NOTE]
 > When translating documents with content in multiple languages, the feature is intended for complete sentences in a single language. If sentences are composed of more than one language, the content may not all translate into the target language.
-> For more information on input requirements, *see* [content limits](get-started-with-document-translation.md#content-limits)
+> For more information on input requirements, *see* [Document Transaltion request limits](../request-limits.md#document-translation)
 
 ## Document Translation development options
 
@@ -70,6 +70,10 @@ Document Translation supports the following document file types:
 |Tab Separated Values/TAB|`tsv`/`tab`| A tab-delimited raw-data file used by spreadsheet programs.|
 |Text|`txt`| An unformatted text document.|
 
+## Request limits
+
+For detailed information regarding Azure Translator Service request limits, *see* [**Document Translation request limits**](../request-limits.md#document-translation).
+
 ### Legacy file types
 
 Source file types are preserved during the document translation with the following **exceptions**:

articles/cognitive-services/Translator/document-translation/quickstarts/get-started-with-rest-api.md

@@ -112,6 +112,8 @@ For this project, you need a **source document** uploaded to your **source conta
 
 A batch Document Translation request is submitted to your Translator service endpoint via a POST request. If successful, the POST method returns a `202 Accepted`  response code and the service creates a batch request. The translated documents are listed in your target container.
 
+For detailed information regarding Azure Translator Service request limits, *see* [**Document Translation request limits**](../../request-limits.md#document-translation).
+
 ### Headers
 
 The following headers are included with each Document Translation API request:

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

@@ -69,6 +69,8 @@ Header|Value| Condition  |
 
 The core operation of the Translator service is translating text. In this quickstart, you build a request using a programming language of your choice that takes a single source (`from`) and provides two outputs (`to`). Then we review some parameters that can be used to adjust both the request and the response.
 
+For detailed information regarding Azure Translator Service request limits, *see* [**Text translation request limits**](request-limits.md#text-translation).
+
 ### [C#: Visual Studio](#tab/csharp)
 
 ### Set up your Visual Studio project

articles/cognitive-services/Translator/request-limits.md

@@ -1,37 +1,41 @@
 ---
-title: Request limits - Translator
+title: Request limits - Translator Service
 titleSuffix: Azure Cognitive Services
-description: This article lists request limits for the Translator. Charges are incurred based on character count, not request frequency with a limit of 50,000 characters per request. Character limits are subscription-based, with F0 limited to 2 million characters per hour.
+description: This article lists request limits for the Translator text and document translation. Charges are incurred based on character count, not request frequency with a limit of 50,000 characters per request. Character limits are subscription-based, with F0 limited to 2 million characters per hour.
 services: cognitive-services
 author: laujan
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: translator-text
 ms.topic: conceptual
-ms.date: 08/17/2022
+ms.date: 04/17/2023
 ms.author: lajanuar
 ---
 
-# Request limits for Translator
+# Request limits for Azure Translator Service
 
-This article provides throttling limits for the Translator translation, transliteration, sentence length detection, language detection, and alternate translations.
+This article provides both a quick reference and detailed description of Azure Translator Service character and array limits for text and document translation.
 
-## Character and array limits per request
+## Text translation
 
-Each translate request is limited to 50,000 characters, across all the target languages you're translating to. For example, sending a translate request of 3,000 characters to translate to three different languages results in a request size of 3000x3 = 9,000 characters, which satisfy the request limit. You're charged per character, not by the number of requests. It's recommended to send shorter requests.
+Charges are incurred based on character count, not request frequency. Character limits are subscription-based.
 
-The following table lists array element and character limits for each operation of the Translator.
+### Character and array limits per request
+
+Each translate request is limited to 50,000 characters, across all the target languages. For example, sending a translate request of 3,000 characters to translate to three different languages results in a request size of 3,000 × 3 = 9,000 characters and meets the request limit. You're charged per character, not by the number of requests, therefore, it's recommended that you send shorter requests.
+
+The following table lists array element and character limits for each text translation operation.
 
 | Operation | Maximum Size of Array Element |    Maximum Number of Array Elements |    Maximum Request Size (characters) |
 |:----|:----|:----|:----|
-| Translate | 50,000| 1,000| 50,000 |
-| Transliterate | 5,000| 10| 5,000 |
-| Detect | 50,000 |100 |50,000 |
-| BreakSentence | 50,000| 100 |50,000 |
-| Dictionary Lookup| 100 |10| 1,000 |
-| Dictionary Examples | 100 for text and 100 for translation (200 total)| 10|2,000 |
+| **Translate** | 50,000| 1,000| 50,000 |
+| **Transliterate** | 5,000| 10| 5,000 |
+| **Detect** | 50,000 |100 |50,000 |
+| **BreakSentence** | 50,000| 100 |50,000 |
+| **Dictionary Lookup** | 100 |10| 1,000 |
+| **Dictionary Examples** | 100 for text and 100 for translation (200 total)| 10|2,000 |
 
-## Character limits per hour
+### Character limits per hour
 
 Your character limit per hour is based on your Translator subscription tier.
 
@@ -56,9 +60,24 @@ Limits for [multi-service subscriptions](./reference/v3-0-reference.md#authentic
 
 These limits are restricted to Microsoft's standard translation models. Custom translation models that use Custom Translator are limited to 3,600 characters per second, per model.
 
-## Latency
+### Latency
+
+The Translator has a maximum latency of 15 seconds using standard models and 120 seconds when using custom models. Typically, responses *for text within 100 characters* are returned in 150 milliseconds to 300 milliseconds. The custom translator models have similar latency characteristics on sustained request rate and may have a higher latency when your request rate is intermittent. Response times vary based on the size of the request and language pair. If you don't receive a translation or an [error response](./reference/v3-0-reference.md#errors) within that time frame, check your code, your network connection, and retry.
+
+## Document Translation
+
+This table lists the content limits for data sent using Document Translation:
+
+|Attribute | Limit|
+|---|---|
+|Document size| ≤ 40 MB |
+|Total number of files.|≤ 1000 |
+|Total content size in a batch | ≤ 250 MB|
+|Number of target languages in a batch| ≤ 10 |
+|Size of Translation memory file| ≤ 10 MB|
 
-The Translator has a maximum latency of 15 seconds using standard models and 120 seconds when using custom models. Typically, responses *for text within 100 characters* are returned in 150 milliseconds to 300 milliseconds. The custom translator models have similar latency characteristics on sustained request rate and may have a higher latency when your request rate is intermittent. Response times will vary based on the size of the request and language pair. If you don't receive a translation or an [error response](./reference/v3-0-reference.md#errors) within that timeframe, check your code, your network connection, and retry.
+> [!NOTE]
+> Document Translation can't be used to translate secured documents such as those with an encrypted password or with restricted access to copy content.
 
 ## Next steps
 

articles/cognitive-services/Translator/toc.yml

@@ -13,6 +13,9 @@ items:
   - name: Pricing
     displayName: cost,free,standard,custom,tier,S1,S2,S3,S4,C2,C3,C4,D3,hosting
     href: https://azure.microsoft.com/pricing/details/cognitive-services/translator
+  - name: Request limits
+    displayName: detection,detect,region,
+    href: request-limits.md
   - name: What's new?
     displayName: release,ga,update,support
     href: whats-new.md
@@ -124,9 +127,6 @@ items:
       href: reference/v3-0-dictionary-lookup.md
     - name: Dictionary Examples
       href: reference/v3-0-dictionary-examples.md
-    - name: Request limits
-      displayName: detection,detect,region,
-      href: request-limits.md
 - name: Document Translation
   items:
     - name: What is Document Translation?

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

@@ -29,12 +29,14 @@ Translator counts the following input:
 * An individual letter.
 * Punctuation.
 * A space, tab, markup, or any white-space character.
-* A repeated translation, even if you've previously translated the same text. Every character submitted to the translate function is counted even when the content is unchanged or the source and target language are the same.
+* A repeated translation, even if you have previously translated the same text. Every character submitted to the translate function is counted even when the content is unchanged or the source and target language are the same.
 
 For scripts based on graphic symbols, such as written Chinese and Japanese Kanji, the Translator service counts the number of Unicode code points. One character per symbol. Exception: Unicode surrogate pairs count as two characters.
 
 Calls to the **Detect** and **BreakSentence** methods aren't counted in the character consumption. However, we do expect calls to the Detect and BreakSentence methods to be reasonably proportionate to the use of other counted functions. If the number of Detect or BreakSentence calls exceeds the number of other counted methods by 100 times, Microsoft reserves the right to restrict your use of the Detect and BreakSentence methods.
 
+For detailed information regarding Azure Translator Service request limits, *see* [**Text translation request limits**](request-limits.md#text-translation).
+
 ## Where can I see my monthly usage?
 
 The [Azure pricing calculator](https://azure.microsoft.com/pricing/calculator/) can be used to estimate your costs. You can also monitor, view, and add Azure alerts for your Azure services in your user account in the Azure portal:
@@ -45,13 +47,13 @@ The [Azure pricing calculator](https://azure.microsoft.com/pricing/calculator/)
 
     :::image type="content" source="media/azure-portal-overview.png" alt-text="Screenshot of the subscription link on overview page in the Azure portal.":::
 
-2. In the left rail, make your selection under **Cost Management**:
+1. In the left rail, make your selection under **Cost Management**:
 
     :::image type="content" source="media/azure-portal-cost-management.png" alt-text="Screenshot of the cost management resources links in the Azure portal.":::
 
 ## Is attribution required when using Translator?
 
-Attribution isn't required when using Translator for text and speech translation. It is recommended that you inform users that the content they're viewing is machine translated.
+Attribution isn't required when using Translator for text and speech translation. It's recommended that you inform users that the content they're viewing is machine translated.
 
 If attribution is present, it must conform to the [Translator attribution guidelines](https://www.microsoft.com/translator/business/attribution/).
 

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

@@ -14,7 +14,7 @@ ms.author: lajanuar
 
 # 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 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 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 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:
 
@@ -24,19 +24,21 @@ Translator documentation contains the following article types:
 
 ## Translator features and development options
 
-The following features are supported by the Translator service. Use the links in this table to learn more about each feature and browse the API references.
+Translator service supports the following features. Use the links in this table to learn more about each feature and browse the API references.
 
 | Feature | Description | Development options |
 |----------|-------------|--------------------------|
 | [**Text Translation**](text-translation-overview.md) | Execute text translation between supported source and target languages in real time. | <ul><li>[**REST API**](reference/rest-api-guide.md) </li><li>[Text translation Docker container](containers/translator-how-to-install-container.md).</li></ul> |
 | [**Document Translation**](document-translation/overview.md) | Translate batch and complex files while preserving the structure and format of the original documents. | <ul><li>[**REST API**](document-translation/reference/rest-api-guide.md)</li><li>[**Client-library SDK**](document-translation/how-to-guides/use-client-sdks.md)</li></ul> |
 | [**Custom Translator**](custom-translator/overview.md) | Build customized models to translate domain- and industry-specific language, terminology, and style. | <ul><li>[**Custom Translator portal**](https://portal.customtranslator.azure.ai/)</li></ul> |
 
+For detailed information regarding Azure Translator Service request limits, *see* [**Text translation request limits**](request-limits.md#text-translation).
+
 ## Try the Translator service for free
 
-First, you'll need a Microsoft account; if you don't have one, you can sign up for free at the [**Microsoft account portal**](https://account.microsoft.com/account).  Select **Create a Microsoft account** and follow the steps to create and verify your new account.
+First, you need a Microsoft account; if you don't have one, you can sign up for free at the [**Microsoft account portal**](https://account.microsoft.com/account).  Select **Create a Microsoft account** and follow the steps to create and verify your new account.
 
-Next, you'll need to  have an Azure account—navigate to the [**Azure sign-up page**](https://azure.microsoft.com/free/ai/), select the **Start free** button, and create a new Azure account using your Microsoft account credentials.
+Next, you need to  have an Azure account—navigate to the [**Azure sign-up page**](https://azure.microsoft.com/free/ai/), select the **Start free** button, and create a new Azure account using your Microsoft account credentials.
 
 Now, you're ready to get started! [**Create a Translator service**](how-to-create-translator-resource.md "Go to the Azure portal."), [**get your access keys and API endpoint**](how-to-create-translator-resource.md#authentication-keys-and-endpoint-url "An endpoint URL and read-only key are required for authentication."), and try our [**quickstart**](quickstart-translator.md "Learn to use Translator via REST.").