Merge pull request #277993 from BrianMouncer/BrianMouncer-pr/1.38.0_updates

documentation updates for the 1.38.0 release.

Author: v-dirichards

articles/ai-services/speech-service/embedded-speech.md

@@ -131,7 +131,7 @@ Follow these steps to install the Speech SDK for Java using Apache Maven:
             <dependency>
             <groupId>com.microsoft.cognitiveservices.speech</groupId>
             <artifactId>client-sdk-embedded</artifactId>
-            <version>1.37.0</version>
+            <version>1.38.0</version>
             </dependency>
         </dependencies>
     </project>
@@ -152,7 +152,7 @@ Be sure to use the `@aar` suffix when the dependency is specified in `build.grad
 
 ```
 dependencies {
-    implementation 'com.microsoft.cognitiveservices.speech:client-sdk-embedded:1.37.0@aar'
+    implementation 'com.microsoft.cognitiveservices.speech:client-sdk-embedded:1.38.0@aar'
 }
 ```
 ::: zone-end

articles/ai-services/speech-service/includes/quickstarts/captioning/java.md

@@ -43,7 +43,7 @@ Before you can do anything, you need to [install the Speech SDK](~/articles/ai-s
             <dependency>
             <groupId>com.microsoft.cognitiveservices.speech</groupId>
             <artifactId>client-sdk</artifactId>
-            <version>1.37.0</version>
+            <version>1.38.0</version>
             </dependency>
         </dependencies>
     </project>

articles/ai-services/speech-service/includes/quickstarts/platform/cpp-requirements.md

@@ -20,11 +20,11 @@ Install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017,
 > [!CAUTION]
 > This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly. For more information, see the [CentOS End Of Life guidance](~/articles/virtual-machines/workloads/centos/centos-end-of-life.md).
 
-The Speech SDK for C++ only supports the following distributions on the x86 (Debian/Ubuntu), x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) architectures:
+The Speech SDK for C++ only supports the following distributions on the x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) architectures:
 
-- Ubuntu 18.04/20.04
-- Debian 10/11
-- Red Hat Enterprise Linux (RHEL) 7/8
+- Ubuntu 20.04/22.04
+- Debian 11/12
+- Red Hat Enterprise Linux (RHEL) 7
 - CentOS 7
 
 [!INCLUDE [Linux distributions](linux-distributions.md)]

articles/ai-services/speech-service/includes/quickstarts/platform/csharp-requirements.md

@@ -22,9 +22,9 @@ Install the [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017,
 
 The Speech SDK for C# only supports the following distributions on the x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) architectures:
 
-- Ubuntu 18.04/20.04
-- Debian 10/11
-- Red Hat Enterprise Linux (RHEL) 7/8
+- Ubuntu 20.04/22.04
+- Debian 11/12
+- Red Hat Enterprise Linux (RHEL) 7
 - CentOS 7
 
 [!INCLUDE [Linux distributions](linux-distributions.md)]

articles/ai-services/speech-service/includes/quickstarts/platform/go-linux.md

@@ -14,9 +14,9 @@ ms.author: eur
 
 The Speech SDK for Go supports the following distributions on the x64 architecture:
 
-- Ubuntu 18.04/20.04
-- Debian 9/10/11
-- Red Hat Enterprise Linux (RHEL) 8
+- Ubuntu 20.04/22.04
+- Debian 11/12
+- Red Hat Enterprise Linux (RHEL) 7
 - CentOS 7
 
 [!INCLUDE [Linux distributions](linux-distributions.md)]

articles/ai-services/speech-service/includes/quickstarts/platform/java-android.md

@@ -50,6 +50,6 @@ Add the Speech SDK as a dependency in your project.
 
    :::image type="content" source="../../../media/sdk/android-studio/sdk-install-3-zoom.png" alt-text="Screenshot that shows how to add a library dependency in Android Studio." lightbox="../../../media/sdk/android-studio/sdk-install-3.png":::
 
-1. In the **Add Library Dependency** window that appears, enter the name and version of the Speech SDK for Java: *com.microsoft.cognitiveservices.speech:client-sdk:1.37.0*. Then select **Search**.
+1. In the **Add Library Dependency** window that appears, enter the name and version of the Speech SDK for Java: *com.microsoft.cognitiveservices.speech:client-sdk:1.38.0*. Then select **Search**.
 1. Make sure that the selected **Group ID** is **com.microsoft.cognitiveservices.speech**, and then select **OK**.
 1. Select **OK** to close the **Project Structure** window and apply your changes to the project.

articles/ai-services/speech-service/includes/quickstarts/platform/java-jre.md

@@ -52,7 +52,7 @@ Follow these steps to install the Speech SDK for Java using Apache Maven:
            <dependency>
            <groupId>com.microsoft.cognitiveservices.speech</groupId>
            <artifactId>client-sdk</artifactId>
-           <version>1.37.0</version>
+           <version>1.38.0</version>
            </dependency>
        </dependencies>
    </project>
@@ -107,7 +107,7 @@ Follow these steps to install the Speech SDK for Java using Apache Maven:
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
-       <version>1.37.0</version>
+       <version>1.38.0</version>
      </dependency>
    </dependencies>
    ```
@@ -124,7 +124,7 @@ Gradle configurations require an explicit reference to the *.jar* dependency ext
 // build.gradle
 
 dependencies {
-    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.37.0", ext: "jar"
+    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.38.0", ext: "jar"
 }
 ```
 

articles/ai-services/speech-service/includes/quickstarts/platform/java-requirements.md

@@ -24,9 +24,9 @@ The Speech SDK for Java doesn't support Windows on ARM64.
 
 The Speech SDK for Java supports the following distributions on the x64, ARM32 (Debian/Ubuntu), and ARM64 (Debian/Ubuntu) architectures:
 
-- Ubuntu 18.04/20.04
-- Debian 10/11
-- Red Hat Enterprise Linux (RHEL) 7/8
+- Ubuntu 20.04/22.04
+- Debian 11/12
+- Red Hat Enterprise Linux (RHEL) 7
 - CentOS 7
 
 [!INCLUDE [Linux distributions](linux-distributions.md)]

articles/ai-services/speech-service/includes/quickstarts/platform/linux-distributions.md

@@ -13,15 +13,10 @@ ms.author: eur
 The Speech SDK depends on the following Linux system libraries:
 
 - The shared libraries of the GNU C library, including the POSIX Threads Programming library, `libpthreads`.
-- The OpenSSL library (`libssl`) version 1.x and certificates (`ca-certificates`).
-- The shared library for ALSA applications (`libasound`).
+- The OpenSSL library, version 1.x (`libssl1`) or 3.x (`libssl3`), and certificates (`ca-certificates`).
+- The shared library for ALSA applications (`libasound2`).
 
-You should also install `ca-certificates` to establish a secure websocket and avoid the `WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED` error.
-
-> [!IMPORTANT]
-> The Speech SDK does not yet support OpenSSL 3.0, which is the default in Ubuntu 22.04 and Debian 12.
-
-# [Ubuntu 18.04/20.04](#tab/ubuntu)
+# [Ubuntu 20.04/22.04](#tab/ubuntu)
 
 Run these commands:
 
@@ -30,16 +25,16 @@ sudo apt-get update
 sudo apt-get install build-essential libssl-dev ca-certificates libasound2 wget
 ```
 
-# [Debian 10/11](#tab/debian)
+# [Debian 11/12](#tab/debian)
 
-To use the Speech SDK in Alpine Linux, create a Debian chroot environment as documented in the Alpine Linux Wiki on [running glibc programs](https://wiki.alpinelinux.org/wiki/Running_glibc_programs). Then follow the Debian instructions here.
+Run these commands:
 
 ```Bash
 sudo apt-get update
 sudo apt-get install build-essential libssl-dev ca-certificates libasound2 wget
 ```
 
-# [RHEL 7/8 and CentOS 7](#tab/rhel-centos)
+# [RHEL/CentOS 7](#tab/rhel-centos)
 
 > [!CAUTION]
 > This article references CentOS, a Linux distribution that is nearing End Of Life (EOL) status. Please consider your use and planning accordingly. For more information, see the [CentOS End Of Life guidance](~/articles/virtual-machines/workloads/centos/centos-end-of-life.md).
@@ -54,7 +49,7 @@ sudo yum install alsa-lib openssl wget
 
 > [!IMPORTANT]
 >
-> - On RHEL/CentOS 7, follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/ai-services/speech-service/how-to-configure-rhel-centos-7.md).
-> - On RHEL, follow the instructions on [how to configure OpenSSL for Linux](~/articles/ai-services/speech-service/how-to-configure-openssl-linux.md).
+> - Follow the instructions on [how to configure RHEL/CentOS 7 for Speech SDK](~/articles/ai-services/speech-service/how-to-configure-rhel-centos-7.md) and [how to configure OpenSSL for Linux](~/articles/ai-services/speech-service/how-to-configure-openssl-linux.md).
+> - Support for RHEL/CentOS 7 will be removed from Speech SDK releases after June 30, 2024 ([CentOS 7 EOL](https://www.redhat.com/topics/linux/centos-linux-eol) and [the end of RHEL 7 Maintenance Support 2](https://access.redhat.com/product-life-cycles?product=Red%20Hat%20Enterprise%20Linux,OpenShift%20Container%20Platform%204)).
 
 ---

articles/ai-services/speech-service/includes/quickstarts/platform/objectivec.md

@@ -34,7 +34,7 @@ The macOS CocoaPod package is available for download and use with the [Xcode 9.4
    use_frameworks!
 
    target 'AppName' do
-     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.37.0'
+     pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.38.0'
    end
    ```
 
@@ -65,7 +65,7 @@ The macOS CocoaPod package is available for download and use with the [Xcode 9.4
     use_frameworks!
 
     target 'AppName' do
-      pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.37.0'
+      pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.38.0'
     end
     ```