Merge pull request #110503 from IEvangelist/translationBasics

Translation basics

Author: shawnmariejones

articles/cognitive-services/Speech-Service/includes/how-to/speech-translation-basics/more.md

@@ -0,0 +1,47 @@
+---
+author: IEvangelist
+ms.service: cognitive-services
+ms.topic: include
+ms.date: 04/06/2020
+ms.author: dapine
+---
+
+## Additional language and platform support
+
+If you've clicked this tab, you probably didn't see a basics article in your favorite programming language. Don't worry, we have additional code samples available on GitHub. Use the table to find the right sample for your programming language and platform/OS combination.
+
+| Language    | Code samples                                                                                                                            |
+|-------------|-----------------------------------------------------------------------------------------------------------------------------------------|
+| C#          | [.NET Framework][csharp-netframework], [.NET Core][csharp-netcore], [UWP][csharp-uwp], [Unity][csharp-unity], [Xamarin][csharp-xamarin] |
+| C++         | [Quickstarts][cpp-quickstarts], [Samples][cpp-samples]                                                                                  |
+| Java        | [Android][java-android], [JRE][java-jre]                                                                                                |
+| JavaScript  | [Browser][js-browser]                                                                                                                   |
+| Node.js     | [Windows, Linux, macOS][node-js]                                                                                                        |
+| Objective-C | [iOS][objective-c-ios], [macOS][objective-c-macos]                                                                                      |
+| Python      | [Windows, Linux, macOS][python]                                                                                                         |
+| Swift       | [iOS][swift-ios], [macOS][swift-macos]                                                                                                  |
+
+<!-- Links -->
+[cpp-quickstarts]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/cpp
+[cpp-samples]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/cpp/linux
+
+[csharp-netframework]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp/dotnet
+[csharp-netcore]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp/dotnetcore
+[csharp-uwp]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp/uwp
+[csharp-unity]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp/unity
+[csharp-xamarin]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp/xamarin
+
+[java-android]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/java/android
+[java-jre]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/java/jre
+
+[js-browser]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/javascript
+
+[node-js]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/javascript
+
+[objective-c-ios]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/ios
+[objective-c-macos]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/macos
+
+[python]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/python
+
+[swift-ios]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/ios
+[swift-macos]: https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/macos

articles/cognitive-services/Speech-Service/includes/how-to/speech-translation-basics/speech-translation-basics-cpp.md

@@ -10,7 +10,7 @@ metadata:
   manager: nitinme
   ms.service: speech-service
   ms.topic: landing-page
-  ms.date: 03/10/2020
+  ms.date: 04/13/2020
   ms.author: dapine
 
 landingContent:
@@ -20,6 +20,8 @@ landingContent:
       links:
       - text: What is speech translation?
         url: speech-translation.md
+      - text: Speech translation basics
+        url: speech-translation-basics.md
     - linkListType: quickstart
       links:
         - text: Translate speech-to-text

articles/cognitive-services/Speech-Service/includes/how-to/speech-translation-basics/speech-translation-basics-csharp.md

@@ -50,7 +50,7 @@ conceptualContent:
         url: index-speech-to-text.yml
     - title: Text-to-speech
       links:
-        - itemType: quickstart
+        - itemType: how-to-guide
           text: Speech synthesis basics
           url: text-to-speech-basics.md
         - itemType: quickstart
@@ -64,15 +64,15 @@ conceptualContent:
         url: index-text-to-speech.yml
     - title: Speech translation
       links:
+      - itemType: how-to-guide
+        text: Speech translation basics
+        url: speech-translation-basics.md
       - itemType: quickstart
         text: Translate speech-to-text
         url: quickstarts/translate-speech-to-text.md
       - itemType: quickstart
         text: Translate speech into multiple target languages
         url: quickstarts/translate-speech-to-text-multiple-languages.md
-      - itemType: quickstart
-        text: Translate speech-to-speech
-        url: quickstarts/translate-speech-to-speech.md
       footerLink:
         text: See more
         url: index-speech-translation.yml

articles/cognitive-services/Speech-Service/includes/how-to/speech-translation-basics/speech-translation-basics-java.md

@@ -0,0 +1,48 @@
+---
+title: Speech translation basics - 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.
+services: cognitive-services
+author: IEvangelist
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: speech-service
+ms.topic: conceptual
+ms.date: 04/13/2020
+ms.author: dapine
+zone_pivot_groups: programming-languages-set-two
+---
+
+# Learn the basics of 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.
+
+> [!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)
+
+::: zone pivot="programming-language-csharp"
+[!INCLUDE [C# Basics include](includes/how-to/speech-translation-basics/speech-translation-basics-csharp.md)]
+::: zone-end
+
+::: zone pivot="programming-language-cpp"
+[!INCLUDE [C++ Basics include](includes/how-to/speech-translation-basics/speech-translation-basics-cpp.md)]
+::: zone-end
+
+::: zone pivot="programming-language-java"
+[!INCLUDE [Java Basics include](includes/how-to/speech-translation-basics/speech-translation-basics-java.md)]
+::: zone-end
+
+::: zone pivot="programming-language-python"
+[!INCLUDE [Python Basics include](includes/how-to/speech-translation-basics/speech-translation-basics-python.md)]
+::: zone-end
+
+::: zone pivot="programming-language-more"
+[!INCLUDE [More languages include](includes/how-to/speech-translation-basics/more.md)]
+::: zone-end
+
+## Next steps
+
+* [Use codec compressed audio formats](how-to-use-codec-compressed-audio-input-streams.md)

articles/cognitive-services/Speech-Service/includes/how-to/speech-translation-basics/speech-translation-basics-python.md

@@ -214,6 +214,8 @@
       items:
         - name: What is speech translation?
           href: speech-translation.md
+        - name: Speech translation basics
+          href: speech-translation-basics.md
     - name: Quickstart
       items:
         - name: Translate speech-to-text