recommended edits (#70)

* recommended edits

* no locale

* upgrade 1.19

Author: eric-urban

articles/cognitive-services/Speech-Service/how-to-configure-openssl-linux.md

@@ -16,8 +16,7 @@ ROBOTS: NOINDEX
 
 # Configure OpenSSL for Linux
 
-In the Speech SDK version 1.19.0 and onwards, [OpenSSL](https://www.openssl.org) is dynamically configured to the host-system version.
-In earlier versions (1.9.0 to 1.18.0) of the Speech SDK, OpenSSL is statically linked to the core library of the SDK.
+With the Speech SDK version 1.19.0 and higher, [OpenSSL](https://www.openssl.org) is dynamically configured to the host-system version. In previous versions, OpenSSL is statically linked to the core library of the SDK.
 
 To ensure connectivity, verify that OpenSSL certificates have been installed in your system. Run a command:
 ```bash

articles/cognitive-services/Speech-Service/how-to-configure-rhel-centos-7.md

@@ -14,7 +14,7 @@ ms.author: pankopon
 
 # Configure RHEL/CentOS 7 for Speech SDK
 
-To use the Speech SDK on RHEL/CentOS 7 x64, update the C++ compiler (for C++ development) and the shared C++ runtime library on your system.
+To use the Speech SDK for C++ development on Red Hat Enterprise Linux (RHEL) 8 x64 and CentOS 8 x64, update the C++ compiler and the shared C++ runtime library on your system.
 
 ### 1. General setup
 

articles/cognitive-services/Speech-Service/how-to-use-codec-compressed-audio-input-streams.md

@@ -11,7 +11,7 @@ ms.topic: conceptual
 ms.date: 03/30/2020
 ms.author: amishu
 ms.custom: devx-track-csharp
-zone_pivot_groups: programming-languages-set-compress-audio-one
+zone_pivot_groups: programming-languages-set-twenty-eight
 ---
 
 # Use codec compressed audio input
@@ -20,11 +20,14 @@ The Speech SDK and Speech CLI can accept compressed audio formats using GStreame
 
 Platform | Languages | Supported GStreamer version
 | :--- | ---: | :---:
-Windows (excluding UWP)  | C++, C#, Java, Python | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) | [Windows installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c)
-Linux  | C++, C#, Java, Python, Go | [supported Linux distributions and target architectures](~/articles/cognitive-services/speech-service/speech-sdk.md) | [Linux installation instructions] (https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c)
-Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.18.3/) | [Android installation instructions] (https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c)
+Linux  | C++, C#, Java, Python, Go | [Supported Linux distributions and target architectures](~/articles/cognitive-services/speech-service/speech-sdk.md) 
+Windows (excluding UWP) | C++, C#, Java, Python | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) 
+Android  | Java | [1.18.3](https://gstreamer.freedesktop.org/data/pkg/android/1.18.3/) 
 
 ## Installing Gstreamer on Linux
+
+For more information see [Linux installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c).  
+
 ```sh
 sudo apt install libgstreamer1.0-0 \
 gstreamer1.0-plugins-base \
@@ -33,6 +36,9 @@ gstreamer1.0-plugins-bad \
 gstreamer1.0-plugins-ugly
 ```
 ## Installing Gstreamer on Windows
+
+For more information see [Windows installation instructions](https://gstreamer.freedesktop.org/documentation/installing/on-windows.html?gi-language=c). 
+
 * Create a folder c:\gstreamer
 * Download [installer](https://gstreamer.freedesktop.org/data/pkg/windows/1.18.3/msvc/gstreamer-1.0-msvc-x86_64-1.18.3.msi) 
 * Copy the installer to c:\gstreamer
@@ -51,6 +57,8 @@ msiexec /passive INSTALLLEVEL=1000 INSTALLDIR=C:\gstreamer /i gstreamer-1.0-msvc
 ## Using Gstreamer in Android
 Look at the Java tab above for the details about building libgstreamer_android.so 
 
+For more information see [Android installation instructions](https://gstreamer.freedesktop.org/documentation/installing/for-android-development.html?gi-language=c). 
+
 ## Speech SDK version required for compressed audio input
 * Speech SDK version 1.10.0 or later is required for RHEL 8 and CentOS 8
 * Speech SDK version 1.11.0 or later is required for for Windows.

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-cpp.md

@@ -8,7 +8,7 @@ ms.author: pafarley
 
 :::row:::
     :::column span="3":::
-        The C++ Speech SDK is available as NuGet package on Windows, Linux, and macOS. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech </a>.
+        The C++ Speech SDK is available as a NuGet package on Windows, Linux, and macOS. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech</a>.
         The C++ Speech SDK is also available as tar package from https://aka.ms/csspeech/linuxbinary.
     :::column-end:::
     :::column:::

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-ios.md

@@ -8,7 +8,7 @@ ms.author: pafarley
 
 :::row:::
     :::column span="3":::
-        When developing for iOS, there are following Speech SDKs available. The Objective-C/Swift Speech SDK is available natively as an iOS CocoaPod package. Alternatively, the .NET Speech SDK could be used with Xamarin.iOS and Unity application frameworks.
+        When developing for iOS, the following Speech SDKs are available. The Objective-C/Swift Speech SDK is available natively as an iOS CocoaPod package. Alternatively, the .NET Speech SDK could be used with Xamarin.iOS and Unity application frameworks.
     :::column-end:::
     :::column:::
         <br>

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-java.md

@@ -8,12 +8,12 @@ ms.author: pafarley
 
 :::row:::
     :::column span="3":::
-        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) </a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.17.0`. (Make sure 1.17.0 is the latest version by [searching our GitHub repo](https://github.com/Azure-Samples/cognitive-services-speech-sdk/search?q=com.microsoft.cognitiveservices.speech%3Aclient-sdk).)
+        The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) </a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.19.0`. (Make sure 1.19.0 is the latest version by [searching our GitHub repo](https://github.com/Azure-Samples/cognitive-services-speech-sdk/search?q=com.microsoft.cognitiveservices.speech%3Aclient-sdk).)
     :::column-end:::
     :::column:::
         <br>
         <div class="icon is-large">
-            <img alt="Java" src="/media/logos/logo_java.svg" width="60px">
+            <img alt="Java" src="https://docs.microsoft.com/media/logos/logo_java.svg" width="60px">
         </div>
     :::column-end:::
 :::row-end:::
@@ -27,7 +27,7 @@ To consume the package from your Android Studio project, make the following chan
 
 2. In the module-level *build.gradle* file, add the following to the `dependencies` section:
   ```gradle
-  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.17.0'
+  implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.19.0'
   ```
 
 The Java SDK is also part of the [Speech Devices SDK](../speech-devices-sdk.md).

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-linux.md

@@ -13,7 +13,7 @@ ms.author: pafarley
     :::column:::
         <br>
         <div class="icon is-large">
-            <img alt="Linux" src="/media/logos/logo_linux-color.svg" width="60px">
+            <img alt="Linux" src="https://docs.microsoft.com/media/logos/logo_linux-color.svg" width="60px">
         </div>
     :::column-end:::
 :::row-end:::

articles/cognitive-services/Speech-Service/includes/get-speech-sdk-macos.md

@@ -6,15 +6,12 @@ ms.date: 03/27/2020
 ms.author: pafarley
 ---
 
-When developing for macOS, there are following Speech SDKs available.
+When developing for macOS, the following Speech SDKs are available.
 
-- The Objective-C/Swift Speech SDK is available natively as a CocoaPod package for Mac x64 and ARM based silicons
-- The .NET Speech SDK is available via NuGet package and could be used with **Xamarin.Mac** and **Unity** application frameworks
-- The Python Speech SDK is available as a PyPI module with Python versions 3.7 and onwards
-- The Java Speech SDK is available via Maven repository as Jar package
-
-> [!TIP]
-> For details using the Objective-C Speech SDK with Swift, see <a href="https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_objective-c_into_swift" target="_blank">Importing Objective-C into Swift </a>.
+- The Objective-C/Swift Speech SDK is available natively as a CocoaPod package for Mac x64 and ARM based silicons. For details about using the Objective-C Speech SDK with Swift, see <a href="https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_objective-c_into_swift" target="_blank">Importing Objective-C into Swift </a>.
+- The .NET Speech SDK is available via NuGet package and could be used with **Xamarin.Mac** and **Unity** application frameworks.
+- The Python Speech SDK is available as a PyPI module for Python versions 3.7 and higher.
+- The Java Speech SDK is available via the Maven repository as a JAR package.
 
 ### System requirements
 

articles/cognitive-services/Speech-Service/includes/how-to/compressed-audio-input/go/examples.md

@@ -6,13 +6,12 @@ ms.date: 09/17/2021
 ms.author: amishu
 ---
 
-To configure Speech SDK to accept compressed audio input, create `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class, specifying the compression format of the stream.
+To configure the Speech SDK to accept compressed audio input, create a `PullAudioInputStream` or `PushAudioInputStream`. Then, create an `AudioConfig` from an instance of your stream class, specifying the compression format of the stream.
 
-Let's assume that your use case is to use `PushStream` for a compressed file. Your code may look like this:
+In the following example let's assume that your use case is to use `PushStream` for a compressed file. 
 
 ```go
 
-```suggestion
 package recognizer
 
 import (

articles/cognitive-services/Speech-Service/includes/how-to/compressed-audio-input/go/prerequisites.md

@@ -6,5 +6,5 @@ ms.date: 09/17/2021
 ms.author: amishu
 ---
 
-Speech SDK can use [GStreamer](https://gstreamer.freedesktop.org) to handle compressed audio. However, for licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Developers need to install several dependencies and plugins, see [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c). Go language is only supported in Speech SDK on the Linux platform. See [Speech SDK Go Documentation](https://github.com/microsoft/cognitive-services-speech-sdk-go) to get started with Microsoft Speech SDK in Go.
+Speech SDK can use [GStreamer](https://gstreamer.freedesktop.org) to handle compressed audio. However, for licensing reasons GStreamer binaries are not compiled and linked with the Speech SDK. Developers need to install several dependencies and plugins, see [Installing on Linux](https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c). Go language is only supported in Speech SDK on the Linux platform. See [Speech SDK for Go](../../../quickstarts/setup-platform.md?pivots=programming-language-go&tabs=dotnet%252cwindows%252cjre%252cbrowser) to get started with Microsoft Speech SDK in Go.