Merge pull request #107884 from IEvangelist/chrisUpdates

Updates based on collaboration with Chris

Author: v-albemi

articles/cognitive-services/Speech-Service/batch-transcription.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: conceptual
-ms.date: 12/17/2019
+ms.date: 03/16/2020
 ms.author: panosper
 ---
 
@@ -291,6 +291,9 @@ The transcription service can handle large number of submitted transcriptions. Y
 
 Complete samples are available in the [GitHub sample repository](https://aka.ms/csspeech/samples) inside the `samples/batch` subdirectory.
 
+> [!NOTE]
+> Batch transcription functionality is exposed via the REST API described above. Thus Batch transcription can be used from nearly any programming language or environment that supports REST. The examples below and samples in GitHub are merely representative and **do not** connote limits on where the API can be used.
+
 You have to customize the sample code with your subscription information, the service region, the SAS URI pointing to the audio file to transcribe, and model IDs in case you want to use a custom acoustic or language model.
 
 [!code-csharp[Configuration variables for batch transcription](~/samples-cognitive-services-speech-sdk/samples/batch/csharp/program.cs#batchdefinition)]

articles/cognitive-services/Speech-Service/conversation-transcription.md

@@ -1,18 +1,18 @@
 ---
 title: Conversation Transcription (Preview) - Speech service
 titleSuffix: Azure Cognitive Services
-description: Conversation Transcription is a speech-to-text solution that combines speech recognition, speaker identification, and sentence attribution to each speaker (also known as diarization) to provide real-time and/or asynchronous transcription of any conversation.
+description: Conversation Transcription is a solution for meetings, that combines recognition, speaker ID, and diarization to provide transcription of any conversation.
 services: cognitive-services
 author: IEvangelist
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: conceptual
-ms.date: 03/11/2020
+ms.date: 03/16/2020
 ms.author: dapine
 ---
 
-# What is Conversation Transcription (Preview)?
+# What is Conversation Transcription in meetings (Preview)?
 
 Conversation Transcription is a [speech-to-text](speech-to-text.md) solution that combines speech recognition, speaker identification, and sentence attribution to each speaker (also known as _diarization_) to provide real-time and/or asynchronous transcription of any conversation. Conversation Transcription distinguishes speakers in a conversation to determine who said what and when, and makes it easy for developers to add speech-to-text to their applications that perform multi-speaker diarization.
 

articles/cognitive-services/Speech-Service/includes/audio-input-format-chart.md

@@ -6,16 +6,10 @@ author: IEvangelist
 manager: nitinme
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 03/10/2020
+ms.date: 03/16/2020
 ms.author: dapine
 ---
 
 ## Supported audio input format
 
-The Speech SDK uses the following format for audio input.
-
-| Format | Codec | Bitrate | Sample Rate     | Channels |
-|--------|-------|---------|-----------------|----------|
-| WAV    | PCM   | 16-bit  | 8 kHz or 16 kHz | 1 (mono) |
-
 [!INCLUDE [supported-audio-formats](supported-audio-formats.md)]

articles/cognitive-services/Speech-Service/includes/supported-audio-formats.md

@@ -2,11 +2,11 @@
 author: IEvangelist
 ms.service: cognitive-services
 ms.topic: include
-ms.date: 03/10/2020
+ms.date: 03/16/2020
 ms.author: dapine
 ---
 
-The default audio streaming format is WAV (16 KHz, 16-bit, and mono PCM). Outside of WAV / PCM, the following codec compressed input formats are also supported:
+The default audio streaming format is WAV (16 KHz or 8Khz, 16-bit, and mono PCM). Outside of WAV / PCM, the compressed input formats listed below are also supported. [Additional configuration](../how-to-use-codec-compressed-audio-input-streams.md) is needed to enable the formats listed below.
 
 - MP3
 - OPUS/OGG

articles/cognitive-services/Speech-Service/index-conversation-scenarios.yml

@@ -1,7 +1,7 @@
 ### YamlMime:Landing
 
 title: Conversation scenarios documentation
-summary: Explore the various conversation scenarios, Conversation Transcription or multi-device conversation.
+summary: Explore the various conversation scenarios. Learn to use Conversation Transcription or Multi-device Conversation in meeting scenarios, and transcription in Call Center scenarios.
 metadata:
   title: Conversation scenarios documentation - Tutorials, API Reference - Azure Cognitive Services | Microsoft Docs
   titleSuffix: Azure Cognitive Services
@@ -10,45 +10,45 @@ metadata:
   manager: nitinme
   ms.service: speech-service
   ms.topic: landing-page
-  ms.date: 03/10/2020
+  ms.date: 03/16/2020
   ms.author: dapine
 
 landingContent:
-- title: About Conversation Transcription
+- title: About Conversation Transcription (meeting scenario)
   linkLists:
     - linkListType: overview
       links:
-      - text: What is Conversation Transcription?
+      - text: What is Conversation Transcription in meetings?
         url: conversation-transcription.md
     - linkListType: how-to-guide
       links:
-        - text: Handle call center scenarios
-          url: call-center-transcription.md
         - text: Real-time Conversation Transcription
           url: how-to-use-conversation-transcription.md
         - text: Asynchronous Conversation Transcription
           url: how-to-async-conversation-transcription.md
-    - linkListType: reference
-      links:
-        - text: Conversation Transcription language support
-          url: conversation-transcription.md#language-support
-- title: About multi-device conversation
+- title: About Multi-device Conversation (meeting scenario)
   linkLists:
     - linkListType: overview
       links:
-      - text: What is multi-device conversation?
+      - text: What is Multi-device Conversation?
         url: multi-device-conversation.md
     - linkListType: quickstart
       links:
         - text: Start and join a conversation
           url: quickstarts/multi-device-conversation.md
-    - linkListType: reference
+- title: Call Center Transcription (custom/agent scenario)
+  linkLists:
+    - linkListType: overview
       links:
-        - text: Multi-device conversation language support
-          url: multi-device-conversation.md#language-support
+        - text: Handle call center scenarios
+          url: call-center-transcription.md
 - title: Reference
   linkLists:
     - linkListType: reference
       links:
+        - text: Conversation Transcription language support
+          url: conversation-transcription.md#language-support
+        - text: Multi-device conversation language support
+          url: multi-device-conversation.md#language-support
         - text: Speech transcription pricing
           url: https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/

articles/cognitive-services/Speech-Service/index.yml

@@ -93,10 +93,10 @@ conceptualContent:
     - title: Conversation scenarios
       links:
         - itemType: overview
-          text: About Conversation Transcription
+          text: About Conversation Transcription (meetings)
           url: conversation-transcription.md
         - itemType: overview
-          text: About multi-device conversations
+          text: About multi-device conversations (meetings)
           url: multi-device-conversation.md
         - itemType: how-to-guide
           text: Call center transcription

articles/cognitive-services/Speech-Service/rest-speech-to-text.md

@@ -3,18 +3,18 @@ title: Speech-to-text API reference (REST) - Speech service
 titleSuffix: Azure Cognitive Services
 description: Learn how to use the speech-to-text REST API. In this article, you'll learn about authorization options, query options, how to structure a request and receive a response.
 services: cognitive-services
-author: erhopf
+author: IEvangelist
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: conceptual
-ms.date: 03/03/2020
-ms.author: erhopf
+ms.date: 03/16/2020
+ms.author: dapine
 ---
 
 # Speech-to-text REST API
 
-As an alternative to the [Speech SDK](speech-sdk.md), the Speech service allows you to convert speech-to-text using a REST API. Each accessible endpoint is associated with a region. Your application requires a subscription key for the endpoint you plan to use.
+As an alternative to the [Speech SDK](speech-sdk.md), the Speech service allows you to convert speech-to-text using a REST API. Each accessible endpoint is associated with a region. Your application requires a subscription key for the endpoint you plan to use. The REST API is very limited, and it should only be used in cases were the [Speech SDK](speech-sdk.md) cannot.
 
 Before using the speech-to-text REST API, understand:
 

articles/cognitive-services/Speech-Service/toc.yml

@@ -97,10 +97,12 @@
               href: rest-speech-to-text.md
             - name: Batch transcription REST API
               href: batch-transcription.md
-        - name: Language support
-          href: 'language-support.md#speech-to-text'
     - name: Resources
       items:
+        - name: Language support
+          href: language-support.md#speech-to-text
+        - name: Region support
+          href: regions.md#speech-to-text-text-to-speech-and-translation
         - name: Speech-to-text FAQ
           displayName: 'FAQ,STT FAQ,SR FAQ,frequently asked questions'
           href: faq-stt.md
@@ -193,14 +195,16 @@
           items:
             - name: Text-to-speech REST API
               href: rest-text-to-speech.md
+    - name: Resources
+      items:
         - name: Standard voice support
-          href: 'language-support.md#standard-voices'
+          href: language-support.md#standard-voices
         - name: Neural voice support
-          href: 'language-support.md#neural-voices'
+          href: language-support.md#neural-voices
+        - name: Region support
+          href: regions.md#speech-to-text-text-to-speech-and-translation
         - name: SSML phonetic sets
           href: speech-ssml-phonetic-sets.md
-    - name: Resources
-      items:
         - name: Text-to-speech FAQ
           displayName: 'FAQ,TTS FAQ,SS FAQ,frequently asked questions'
           href: faq-text-to-speech.md
@@ -249,10 +253,12 @@
             - name: Release notes
               displayName: 'release notes,updates,what''s new,what is new,changes'
               href: releasenotes.md
-        - name: Language support
-          href: 'language-support.md#speech-translation'
     - name: Resources
       items:
+        - name: Language support
+          href: language-support.md#speech-translation
+        - name: Region support
+          href: regions.md#speech-to-text-text-to-speech-and-translation
         - name: Speech translation FAQ
           href: 'https://www.microsoft.com/translator/faq.aspx'
 - name: Intent recognition
@@ -297,6 +303,12 @@
           items:
             - name: LUIS developer resources
               href: https://docs.microsoft.com/azure/cognitive-services/luis/developer-reference-resource
+    - name: Resources
+      items:
+        - name: Language support
+          href: ../luis/luis-language-support.md
+        - name: Region support
+          href: regions.md#intent-recognition
 - name: Conversation scenarios
   items:
     - name: Conversation scenarios documentation