Merge pull request #127530 from trevorbye/main

[CogSvcs] translation quickstart refactor & toc changes

Author: v-shils

.openpublishing.redirection.json

@@ -40043,6 +40043,26 @@
       "redirect_url": "/azure/cognitive-services/speech-service/custom-keyword-overview",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/cognitive-services/Speech-Service/speech-translation-basics.md",
+      "redirect_url": "/azure/cognitive-services/speech-service/get-started-speech-translation",
+      "redirect_document_id": true
+    },
+    {
+      "source_path": "articles/cognitive-services/Speech-Service/translate-speech-to-speech.md",
+      "redirect_url": "/azure/cognitive-services/speech-service/get-started-speech-translation",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Speech-Service/translate-speech-to-text.md",
+      "redirect_url": "/azure/cognitive-services/speech-service/get-started-speech-translation",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/cognitive-services/Speech-Service/translate-speech-to-text-multiple-languages.md",
+      "redirect_url": "/azure/cognitive-services/speech-service/get-started-speech-translation",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/LUIS/luis-get-started-ruby-get-intent.md",
       "redirect_url": "/azure/cognitive-services/LUIS/",

articles/cognitive-services/Speech-Service/speech-translation-basics.md renamed to articles/cognitive-services/Speech-Service/get-started-speech-translation.md

@@ -1,28 +1,29 @@
 ---
-title: Speech translation basics - Speech service
+title: Speech translation quickstart - Speech service
 titleSuffix: Azure Cognitive Services
-description: Learn how to use the Speech SDK to translate speech. In this article, you'll learn about object construction, supported audio input formats, and configuration options for speech translation.
+description: Learn how to use the Speech SDK to translate speech. In this quickstart, you learn about object construction, supported audio input formats, and configuration options for speech translation.
 services: cognitive-services
 author: trevorbye
 manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: conceptual
-ms.date: 04/13/2020
+ms.date: 08/27/2020
 ms.author: trbye
 ms.custom: "devx-track-javascript, devx-track-csharp"
 zone_pivot_groups: programming-languages-set-two-with-js
 ---
 
-# Learn the basics of speech translation
+# Get started with speech translation
 
-One of the core features of the Speech service is the ability to recognize human speech and translate it to other languages. In this article you'll learn how to use the Speech SDK in your apps and products to perform high-quality speech translation.
+One of the core features of the Speech service is the ability to recognize human speech and translate it to other languages. In this quickstart you learn how to use the Speech SDK in your apps and products to perform high-quality speech translation. This quickstart covers topics including:
+
+* Translating speech-to-text
+* Translating speech to multiple target languages
+* Performing direct speech-to-speech translation
 
 > [!TIP]
-> If you haven't had a chance to complete one of our quickstarts, we encourage you to kick the tires and try speech translation out for yourself.
-> * [Translate speech-to-text](quickstarts/translate-speech-to-text.md)
-> * [Translate speech to multiple languages](quickstarts/translate-speech-to-text-multiple-languages.md)
-> * [Translate speech-to-speech](quickstarts/translate-speech-to-speech.md)
+> If you want to skip straight to sample code, see the [quickstart samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart) on GitHub.
 
 ::: zone pivot="programming-language-csharp"
 [!INCLUDE [C# Basics include](includes/how-to/speech-translation-basics/speech-translation-basics-csharp.md)]
@@ -51,3 +52,4 @@ One of the core features of the Speech service is the ability to recognize human
 ## Next steps
 
 * [Use codec compressed audio formats](how-to-use-codec-compressed-audio-input-streams.md)
+* See the [quickstart samples](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart) on GitHub.

articles/cognitive-services/Speech-Service/includes/quickstarts/quickstart-list.md

@@ -1,7 +1,7 @@
 - [Quickstart: Recognize speech from a microphone](~/articles/cognitive-services/speech-service/quickstarts/speech-to-text-from-microphone.md)
 - [Quickstart: Recognize speech from a file](~/articles/cognitive-services/speech-service/quickstarts/speech-to-text-from-file.md)
 - [Quickstart: Recognize speech from an Azure Blob](~/articles/cognitive-services/speech-service/quickstarts/from-blob.md)
-- [Quickstart: Translate speech-to-text](~/articles/cognitive-services/speech-service/quickstarts/translate-speech-to-text.md)
+- [Quickstart: Translate speech-to-text](~/articles/cognitive-services/speech-service/get-started-speech-translation.md)
 - [Quickstart: Synthesize text to an audio device](~/articles/cognitive-services/speech-service/quickstarts/text-to-speech.md)
 - [Quickstart: Synthesize text to a file](~/articles/cognitive-services/speech-service/quickstarts/text-to-speech-audio-file.md)
 - [Quickstart: Recognize Intents](~/articles/cognitive-services/speech-service/quickstarts/intent-recognition.md)

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

@@ -26,12 +26,8 @@ landingContent:
         url: spx-overview.md
     - linkListType: quickstart
       links:
-        - text: Translate speech-to-text
-          url: quickstarts/translate-speech-to-text.md
-        - text: Translate speech into multiple target languages
-          url: quickstarts/translate-speech-to-text-multiple-languages.md
-        - text: Translate speech-to-speech
-          url: quickstarts/translate-speech-to-speech.md
+        - text: Get started with speech translation
+          url: get-started-speech-translation.md
 - title: Develop with speech translation
   linkLists:
     - linkListType: learn

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

@@ -64,15 +64,12 @@ conceptualContent:
         url: index-text-to-speech.yml
     - title: Speech translation
       links:
+      - itemType: overview
+        text: About speech translation
+        url: speech-translation.md
       - itemType: quickstart
-        text: Translate speech-to-text
-        url: quickstarts/translate-speech-to-text.md
-      - itemType: quickstart
-        text: Translate speech to multiple languages
-        url: quickstarts/translate-speech-to-text-multiple-languages.md
-      - itemType: how-to-guide
-        text: Speech translation basics
-        url: speech-translation-basics.md        
+        text: Get started with speech translation
+        url: get-started-speech-translation.md      
       footerLink:
         text: More
         url: index-speech-translation.yml

articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-speech.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: conceptual
-ms.date: 03/11/2020
+ms.date: 08/27/2020
 ms.author: erhopf
 ms.custom: devx-track-csharp
 ---
@@ -25,25 +25,14 @@ Today, Microsoft uses NMT for translation to most popular languages. All [langua
 
 ## Core features
 
-Here are the features available via the Speech SDK and REST APIs:
+* Speech-to-text translation with recognition results.
+* Speech-to-speech translation.
+* Support for translation to multiple target languages.
+* Interim recognition and translation results.
 
-| Use case | SDK | REST |
-|----------|-----|------|
-| Speech-to-text translation with recognition results. | Yes | No |
-| Speech-to-speech translation. | Yes | No |
-| Interim recognition and translation results. | Yes | No |
+## Get started 
 
-## Get started with speech translation
-
-We offer quickstarts designed to have you running code in less than 10 minutes. This table includes a list of speech translation quickstarts organized by language.
-
-| Quickstart | Platform | API reference |
-|------------|----------|---------------|
-| [C#, .NET Core](~/articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-text.md?pivots=programming-language-csharp&tabs=dotnetcore) | Windows | [Browse](https://aka.ms/csspeech/csharpref) |
-| [C#, .NET Framework](~/articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-text.md?pivots=programming-language-csharp&tabs=dotnet) | Windows | [Browse](https://aka.ms/csspeech/csharpref) |
-| [C#, UWP](~/articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-text.md?pivots=programming-language-csharp&tabs=uwp) | Windows | [Browse](https://aka.ms/csspeech/csharpref) |
-| [C++](~/articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-text.md?pivots=programming-language-cpp&tabs=windows) | Windows | [Browse](https://aka.ms/csspeech/cppref)|
-| [Java](~/articles/cognitive-services/Speech-Service/quickstarts/translate-speech-to-text.md?pivots=programming-language-java&tabs=jre) | Windows, Linux, macOS | [Browse](https://aka.ms/csspeech/javaref) |
+See the [quickstart](get-started-speech-translation.md) to get started with speech translation. The speech translation service is available via the [Speech SDK](speech-sdk.md) and the [Speech CLI](spx-overview.md).
 
 ## Sample code
 
@@ -67,5 +56,6 @@ If your applications, tools, or products are using the [Translator Speech API](h
 
 ## Next steps
 
+* Complete the speech translation [quickstart](get-started-speech-translation.md)
 * [Get a Speech service subscription key for free](get-started.md)
 * [Get the Speech SDK](speech-sdk.md)