Merge pull request #98235 from IEvangelist/sdkLinks

[CogSvcs] created an include, to provide ref docs with correct links

Author: v-albemi

articles/cognitive-services/Speech-Service/devices-sdk-release-notes.md

@@ -19,14 +19,14 @@ The following sections list changes in the most recent releases.
 
 ## Speech Devices SDK 1.7.0:
 
-*	Linux ARM is now supported.
-*	Initial binaries for Roobov2 are provided (Linux ARM64).
-*	Windows users can use AudioConfig.fromDefaultMicrophoneInput() or AudioConfig.fromMicrophoneInput(deviceName) to specify the microphone to be used.
-*	The library size has been optimized.
-*	Support for multi-turn recognition using the same speech/intent recognizer object.
-*	Fix occasional hang that would occur while stopping recognition.
-*	Sample apps now contain a sample participants.properties file to demonstrate the format of the file.
-*	Updated the [Speech SDK](https://docs.microsoft.com/azure/cognitive-services/speech-service/speech-sdk-reference) component to version 1.7.0. For more information, see its [release notes](https://aka.ms/csspeech/whatsnew).
+- Linux ARM is now supported.
+- Initial binaries for Roobo v2 are provided (Linux ARM64).
+- Windows users can use `AudioConfig.fromDefaultMicrophoneInput()` or `AudioConfig.fromMicrophoneInput(deviceName)` to specify the microphone to be used.
+- The library size has been optimized.
+- Support for multi-turn recognition using the same speech/intent recognizer object.
+- Fix occasional hang that would occur while stopping recognition.
+- Sample apps now contain a sample participants.properties file to demonstrate the format of the file.
+- Updated the [Speech SDK](https://docs.microsoft.com/azure/cognitive-services/speech-service/speech-sdk-reference) component to version 1.7.0. For more information, see its [release notes](https://aka.ms/csspeech/whatsnew).
 
 ## Speech Devices SDK 1.6.0:
 
@@ -64,8 +64,8 @@ The following sections list changes in the most recent releases.
 
 - [Installing a keyword](https://docs.microsoft.com/azure/cognitive-services/speech-service/speech-devices-sdk-create-kws) has been simplified, it is now part of the app and does not need separate installation on the device.
 - The keyword recognition has changed, and two events are supported.
-  - RecognizingKeyword, indicates the speech result contains (unverified) keyword text.
-  - RecognizedKeyword, indicates that keyword recognition completed recognizing the given keyword.
+  - `RecognizingKeyword,` indicates the speech result contains (unverified) keyword text.
+  - `RecognizedKeyword`, indicates that keyword recognition completed recognizing the given keyword.
 
 ## Speech Devices SDK 1.1.0: 2018-Nov release
 

articles/cognitive-services/Speech-Service/includes/speech-reference-doc-links.md

@@ -0,0 +1,42 @@
+---
+title: Speech service
+titleSuffix: Azure Cognitive Services
+services: cognitive-services
+author: IEvangelist
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: speech-service
+ms.topic: include
+ms.date: 12/06/2019
+ms.author: dapine
+---
+
+## Reference docs
+
+The Speech service provides two SDKs. The first SDK is the primary [Speech SDK](../speech-sdk.md) and provides most of the functionalities needed to interact with the Speech service. The second SDK is specific to devices, appropriately named the [Speech Devices SDK](../speech-devices-sdk.md). Both SDKs are available in many languages.
+
+### Speech SDK reference docs
+
+Use the following list to find the appropriate Speech SDK reference docs:
+
+- <a href="https://aka.ms/csspeech/csharpref" target="_blank" rel="noopener">C# SDK <span class="docon docon-navigate-external x-hidden-focus"></span></a>
+- <a href="https://aka.ms/csspeech/cppref" target="_blank" rel="noopener">C++ SDK <span class="docon docon-navigate-external x-hidden-focus"></span></a>
+- <a href="https://aka.ms/csspeech/javaref" target="_blank" rel="noopener">Java SDK <span class="docon docon-navigate-external x-hidden-focus"></span></a>
+- <a href="https://aka.ms/csspeech/pythonref" target="_blank" rel="noopener">Python SDK<span class="docon docon-navigate-external x-hidden-focus"></span></a>
+- <a href="https://aka.ms/csspeech/javascriptref" target="_blank" rel="noopener">JavaScript SDK<span class="docon docon-navigate-external x-hidden-focus"></span></a>
+- <a href="https://aka.ms/csspeech/objectivecref" target="_blank" rel="noopener">Objective-C SDK <span class="docon docon-navigate-external x-hidden-focus"></span></a>
+
+> [!TIP]
+> The Speech service SDK is actively maintained and updated. To track changes, updates and feature additions refer to the [Speech SDK release notes](../releasenotes.md).
+
+### Speech Devices SDK reference docs
+
+The [Speech Devices SDK](../speech-devices-sdk.md) is a superset of the Speech SDK, with extended functionality for specific devices. To download the Speech Devices SDK, you must first [choose a development kit](../get-speech-devices-sdk.md#choose-a-development-kit).
+
+### REST API references
+
+For references of various Speech service REST APIs, refer to the listing below:
+
+- [REST API: Speech-to-text](../rest-speech-to-text.md)
+- [REST API: Text-to-speech](../rest-text-to-speech.md)
+- <a href="https://cris.ai/swagger/ui/index" target="_blank" rel="noopener">REST API: Batch transcription and customization <span class="docon docon-navigate-external x-hidden-focus"></span></a>