Merge pull request #2867 from MicrosoftDocs/main

2/11/2025 AM Publish

Author: Taojunshen

articles/ai-services/document-intelligence/quickstarts/includes/csharp-sdk.md

@@ -678,15 +678,15 @@ for (int i = 0; i < result.Documents.Count; i++)
     }
 
     if (document.Fields.TryGetValue("Items", out DocumentField itemsField)
-        && itemsField.Type == DocumentFieldType.Array)
+        && itemsField.Type == DocumentFieldType.List)
     {
-        foreach (DocumentField itemField in itemsField.ValueArray)
+        foreach (DocumentField itemField in itemsField.ValueList)
         {
             Console.WriteLine("Item:");
 
-            if (itemField.Type == DocumentFieldType.Object)
+            if (itemField.Type == DocumentFieldType.Dictionary)
             {
-                IReadOnlyDictionary<string, DocumentField> itemFields = itemField.ValueObject;
+                IReadOnlyDictionary<string, DocumentField> itemFields = itemField.ValueDictionary;
 
                 if (itemFields.TryGetValue("Description", out DocumentField itemDescriptionField)
                     && itemDescriptionField.Type == DocumentFieldType.String)

articles/ai-services/document-intelligence/versioning/sdk-overview-v4-0.md

@@ -83,7 +83,7 @@ The following tables present the correlation between each SDK version the suppor
 
 | Language| SDK alias | API version (default)            | Supported clients|
 | :------ | :-----------|:---------- | :-----------------|
-| **Python 1.0.0b2**| v4.0 (GA)| 2024-11-30 GA |**DocumentIntelligenceClient**</br>**DocumentIntelligenceAdministrationClient**|
+| **Python 1.0.0**| v4.0 (GA)| 2024-11-30 GA |**DocumentIntelligenceClient**</br>**DocumentIntelligenceAdministrationClient**|
 | **Python 3.3.0**| v3.1 latest (GA)| 2023-07-31|  **DocumentAnalysisClient**</br>**DocumentModelAdministrationClient**|
 | **Python 3.2.x**| v3.0 (GA)| 2022-08-31|  **DocumentAnalysisClient**</br>**DocumentModelAdministrationClient**|
 | **Python 3.1.x**| v2.1 |  v2.1  |  **FormRecognizerClient**</br>**FormTrainingClient** |

articles/ai-services/speech-service/migrate-to-batch-synthesis.md

@@ -6,7 +6,7 @@ author: eric-urban
 ms.author: eur
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: concept-article
 ms.date: 9/20/2024
 ms.reviewer: heikora
 ms.devlang: csharp

articles/ai-services/speech-service/rest-speech-to-text-short.md

@@ -5,7 +5,7 @@ description: Learn how to use Speech to text REST API for short audio to convert
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: how-to
 ms.date: 9/23/2024
 ms.author: eur
 ms.devlang: csharp

articles/ai-services/speech-service/rest-speech-to-text.md

@@ -4,7 +4,7 @@ titleSuffix: Azure AI services
 description: Get reference documentation for Speech to text REST API.
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: concept-article
 ms.date: 11/12/2024
 ms.reviewer: eur
 author: eric-urban

articles/ai-services/speech-service/rest-text-to-speech.md

@@ -5,7 +5,7 @@ description: Learn how to use the REST API to convert text into synthesized spee
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: how-to
 ms.date: 9/23/2024
 ms.author: eur
 ms.custom: references_regions

articles/ai-services/speech-service/spx-batch-operations.md

@@ -5,7 +5,7 @@ description: Learn how to do batch speech to text (speech recognition), batch te
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: how-to
 ms.date: 9/24/2024
 ms.author: eur
 ms.custom: mode-api

articles/ai-services/speech-service/spx-data-store-configuration.md

@@ -5,7 +5,7 @@ description: Learn how to configure the Speech CLI datastore.
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: how-to
 ms.date: 9/24/2024
 ms.author: eur
 ms.custom: mode-api

articles/ai-services/speech-service/spx-output-options.md

@@ -5,7 +5,7 @@ description: Learn how to configure output options with the Speech CLI.
 author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
-ms.topic: reference
+ms.topic: how-to
 ms.date: 9/24/2024
 ms.author: eur
 #Customer intent: As a developer, I want to learn how to configure output options with the Speech CLI.

articles/ai-services/translator/document-translation/quickstarts/includes/sdk/python.md

@@ -153,13 +153,13 @@ def sample_single_document_translation():
 
     # absolute path to your document
     file_path = "C:/{your-file-path}/document-translation-sample.docx"
-    file_name = os.path.path.basename(file_path)
+    file_name = os.path.basename(file_path)
     file_type = (
         "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
     )
     print(f"File for translation: {file_name}")
 
-    with open(file_name, "r") as file:
+    with open(file_path, "rb") as file:
         file_contents = file.read()
 
     document_content = (file_name, file_contents, file_type)
@@ -168,8 +168,12 @@ def sample_single_document_translation():
     response_stream = client.document_translate(
         body=document_translate_content, target_language=target_language
     )
-    translated_response = response_stream.decode("utf-8-sig")  # type: ignore[attr-defined]
-    print(f"Translated response: {translated_response}")
+    # Save the response_stream to a file
+    output_file_path = "./translated-document.docx"
+    with open(output_file_path, "wb") as output_file:
+        output_file.write(response_stream)
+    
+    print(f"Translated document saved to: {output_file_path}")
 
 
 if __name__ == "__main__":