Merge pull request #100811 from jhakulin/jhakulin-pr/update-speech-docs

[Cog svcs] Add new page for OpenSSL configuration and update CTS how to guide

Author: v-albemi

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

@@ -0,0 +1,28 @@
+---
+title: How to configure OpenSSL for Linux
+titleSuffix: Azure Cognitive Services
+description: Learn how to configure OpenSSL for Linux.
+services: cognitive-services
+author: jhakulin
+manager: nitinme
+ms.service: cognitive-services
+ms.subservice: speech-service
+ms.topic: conceptual
+ms.date: 01/15/2020
+ms.author: jhakulin
+---
+
+# Configure OpenSSL for Linux
+
+OpenSSL is dynamically configured to the host-system version when using any Speech SDK release version prior to 1.9.0.
+
+Starting at the Speech SDK version 1.9.0 and onwards, OpenSSL (version 1.1.1b) is statically linked to the Speech SDK core library.
+
+## Troubleshoot connectivity
+
+In case of connection failures with 1.9.0 release, please check that OpenSSL `ssl/certs` directory exists in `/usr/lib` directory under the Linux system. If `ssl/certs` does not exist, please check where OpenSSL is installed in your system (using `which openssl` command), and locate openssl `certs`directory and copy the content of that directory into `/usr/lib/ssl/certs` directory.
+
+## Next steps
+
+> [!div class="nextstepaction"]
+> [Check the general overview about the Speech SDK capabilities and supported platforms](speech-sdk.md)

articles/cognitive-services/Speech-Service/how-to-use-conversation-transcription.md

@@ -66,7 +66,7 @@ class Program
         // Edit with your desired region for `{region}`
         var response = await client.PostAsync($"https://signature.{region}.cts.speech.microsoft.com/api/v1/Signature/GenerateVoiceSignatureFromFormData", form);
         // A voice signature contains Version, Tag and Data key values from the Signature json structure from the Response body.
-        // Voice signature format example: { "Version": <Numeric value>, "Tag": "string", "Data": "string" }
+        // Voice signature format example: { "Version": <Numeric string or integer value>, "Tag": "string", "Data": "string" }
         var jsonData = await response.Content.ReadAsStringAsync();
     }
 
@@ -85,7 +85,7 @@ class Program
         // Edit with your desired region for `{region}`
         var response = await client.PostAsync($"https://signature.{region}.cts.speech.microsoft.com/api/v1/Signature/GenerateVoiceSignatureFromByteArray", content);
         // A voice signature contains Version, Tag and Data key values from the Signature json structure from the Response body.
-        // Voice signature format example: { "Version": <Numeric value>, "Tag": "string", "Data": "string" }
+        // Voice signature format example: { "Version": <Numeric string or integer value>, "Tag": "string", "Data": "string" }
         var jsonData = await response.Content.ReadAsStringAsync();
     }
 
@@ -108,6 +108,7 @@ Sample code highlights include:
 - Registering the events of interest
 - Adding or removing participants to the conversation using the Conversation object
 - Streaming the audio
+- In Speech SDK version 1.9.0 and onwards both `int` and `string` value types are supported in the voice signature version field.
 
 The transcription and speaker identifier come back in the registered events.
 
@@ -184,7 +185,7 @@ public class MyConversationTranscriber
                     // Add participants to the conversation.
                     // Create voice signatures using REST API described in the earlier section in this document.
                     // Voice signature needs to be in the following format:
-                    // { "Version": <Numeric value>, "Tag": "string", "Data": "string" }
+                    // { "Version": <Numeric string or integer value>, "Tag": "string", "Data": "string" }
 
                     var speakerA = Participant.From("Speaker_A", "en-us", signatureA);
                     var speakerB = Participant.From("Speaker_B", "en-us", signatureB);

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

@@ -452,7 +452,9 @@
       href: how-to-use-logging.md
     - name: How to track memory usage
       href: how-to-track-speech-sdk-memory-usage.md
-      displayName: "memory usage, memory consumption, object logging, object tracking, memory"
+    - name: How to configure OpenSSL for Linux
+      href: how-to-configure-openssl-linux.md
+      displayName: "memory usage, memory consumption, object logging, object tracking, memory, openssl"
   - name: Samples
     items:
     - name: Speech SDK Samples (GitHub)