refresh speech docs

eric-urban · eric-urban · commit ff3390b5923b · 2024-09-20T07:58:08.000-07:00
diff --git a/articles/ai-services/speech-service/includes/previews/preview-generic.md b/articles/ai-services/speech-service/includes/previews/preview-generic.md
@@ -0,0 +1,13 @@
+---
+title: include file
+description: include file
+author: eric-urban
+ms.author: eur
+ms.service: azure-ai-speech
+ms.topic: include
+ms.date: 9/20/2024
+ms.custom: include
+---
+
+> [!NOTE]
+> This feature is currently in public preview. This preview is provided without a service-level agreement, and is not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
diff --git a/articles/ai-services/speech-service/includes/previews/preview-personal-voice.md b/articles/ai-services/speech-service/includes/previews/preview-personal-voice.md
diff --git a/articles/ai-services/speech-service/meeting-transcription.md b/articles/ai-services/speech-service/meeting-transcription.md
@@ -6,9 +6,10 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 9/9/2024
+ms.date: 9/20/2024
 ms.author: eur
 ms.custom: cogserv-non-critical-speech, references_regions
+#Customer intent: For developers who want to use the conversation transcription feature in the Speech service to transcribe meetings.
 ---
 
 # What is conversation transcription multichannel diarization? (preview)
diff --git a/articles/ai-services/speech-service/migrate-to-batch-synthesis.md b/articles/ai-services/speech-service/migrate-to-batch-synthesis.md
@@ -2,22 +2,24 @@
 title: Migrate to Batch synthesis API - Speech service
 titleSuffix: Azure AI services
 description: This document helps developers migrate code from Long Audio REST API to Batch synthesis REST API.
-author: heikora
-manager: dongli
+author: eric-urban
+ms.author: eur
+manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: reference
-ms.date: 1/21/2024
-ms.author: heikora
+ms.date: 9/20/2024
+ms.reviewer: heikora
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+#Customer intent: As a developer, I want to migrate code from Long Audio REST API to Batch synthesis REST API in the Speech service.
 ---
 
 # Migrate code from Long Audio API to Batch synthesis API
 
 The [Batch synthesis API](batch-synthesis.md) provides asynchronous synthesis of long-form text to speech. This article describes the benefits of upgrading from Long Audio API to Batch synthesis API, and details about how to do so.
 
 > [!IMPORTANT]
-> [Batch synthesis API](batch-synthesis.md) is generally available. the Long Audio API will be retired on April 1st, 2027.
+> [Batch synthesis API](batch-synthesis.md) is generally available. the Long Audio API is retiring on April 1st, 2027.
 
 ## Base path and version
 
diff --git a/articles/ai-services/speech-service/migrate-to-custom-voice-api.md b/articles/ai-services/speech-service/migrate-to-custom-voice-api.md
@@ -6,16 +6,16 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 1/21/2024
+ms.date: 9/20/2024
 ms.author: eur
+#Customer intent: As a developer, I want to migrate code from v3 text to speech REST API to custom voice REST API in the Speech service.
 ---
 
 # Migrate to custom voice REST API (Preview)
 
-The custom voice REST API is a new version of the text to speech REST API. You can deploy and use custom neural voice models with the API. 
+[!INCLUDE [Feature preview](./includes/previews/preview-generic.md)]
 
-> [!NOTE]
-> The custom voice REST API is currently in preview. 
+The custom voice REST API is a new version of the text to speech REST API. You can deploy and use custom neural voice models with the API. 
 
 In this article, you learn how to migrate code from the v3 text to speech REST API to the custom voice REST API.
 
diff --git a/articles/ai-services/speech-service/migrate-v3-0-to-v3-1.md b/articles/ai-services/speech-service/migrate-v3-0-to-v3-1.md
@@ -2,14 +2,16 @@
 title: Migrate from v3.0 to v3.1 REST API - Speech service
 titleSuffix: Azure AI services
 description: This document helps developers migrate code from v3.0 to v3.1 of the Speech to text REST API.
-author: heikora
-manager: dongli
+author: eric-urban
+ms.author: eur
+manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 9/15/2024
-ms.author: heikora
+ms.date: 9/20/2024
+ms.reviewer: heikora
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+#Customer intent: As a developer, I want to migrate code from v3.0 to v3.1 of the Speech to text REST API.
 ---
 
 # Migrate code from v3.0 to v3.1 of the REST API
diff --git a/articles/ai-services/speech-service/migrate-v3-1-to-v3-2.md b/articles/ai-services/speech-service/migrate-v3-1-to-v3-2.md
@@ -6,10 +6,11 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: how-to
-ms.date: 9/15/2024
+ms.date: 9/20/2024
 ms.author: eur
 ms.devlang: csharp
 ms.custom: devx-track-csharp
+#Customer intent: As a developer, I want to migrate code from v3.1 to v3.2 of the Speech to text REST API.
 ---
 
 # Migrate code from v3.1 to v3.2 of the REST API
diff --git a/articles/ai-services/speech-service/migration-overview-neural-voice.md b/articles/ai-services/speech-service/migration-overview-neural-voice.md
@@ -6,8 +6,9 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: conceptual
-ms.date: 1/21/2024
+ms.date: 9/20/2024
 ms.author: eur
+#Customer intent: As a developer, I want to migrate from non-neural voice to neural voice in the Speech service.
 ---
 
 # Migration to neural voice
diff --git a/articles/ai-services/speech-service/multi-device-conversation.md b/articles/ai-services/speech-service/multi-device-conversation.md
@@ -6,9 +6,10 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 1/21/2024
+ms.date: 9/20/2024
 ms.author: eur
 ms.custom: cogserv-non-critical-speech
+#Customer intent: As a developer, I want to learn about multi-device conversation in the Speech service.
 ---
 
 # What is multi-device conversation?
diff --git a/articles/ai-services/speech-service/openai-speech.md b/articles/ai-services/speech-service/openai-speech.md
@@ -7,7 +7,7 @@ manager: nitinme
 ms.service: azure-ai-speech
 ms.custom: build-2023, build-2023-dataai, devx-track-python
 ms.topic: how-to
-ms.date: 9/5/2024
+ms.date: 9/20/2024
 ms.author: eur
 zone_pivot_groups: programming-languages-csharp-python
 keywords: speech to text, openai
diff --git a/articles/ai-services/speech-service/openai-voices.md b/articles/ai-services/speech-service/openai-voices.md
@@ -7,7 +7,7 @@ ms.author: eur
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 8/20/2024
+ms.date: 9/20/2024
 ms.reviewer: v-baolianzou
 ms.custom: references_regions
 #customer intent: As a user who implements text to speech, I want to understand the options and differences between available OpenAI text to speech voices in Azure AI services.
@@ -75,7 +75,7 @@ The following table outlines the Speech Synthesis Markup Language (SSML) element
 | `<lang>` | Indicates the default locale for the language that you want the neural voice to speak.  |
 | `<break>` | Use to override the default behavior of breaks or pauses between words. |
 
-## Next steps
+## Related content
 
 - [Try the text to speech quickstart in Azure AI Speech](get-started-text-to-speech.md#openai-text-to-speech-voices-in-azure-ai-speech)
 - [Try the text to speech via Azure OpenAI Service](../openai/text-to-speech-quickstart.md)
diff --git a/articles/ai-services/speech-service/overview.md b/articles/ai-services/speech-service/overview.md
@@ -6,8 +6,9 @@ author: eric-urban
 manager: nitinme
 ms.service: azure-ai-speech
 ms.topic: overview
-ms.date: 8/20/2024
+ms.date: 9/20/2024
 ms.author: eur
+#Customer intent: As a developer, I want to learn about the Speech service and its capabilities to add speech to my applications, tools, and devices.
 ---
 
 # What is the Speech service?
