cross links etc

eric-urban · eric-urban · commit 3fa28a0a53f2 · 2023-04-18T11:14:48.000-07:00
diff --git a/articles/cognitive-services/Speech-Service/includes/containers-cstt-common-run.md b/articles/cognitive-services/Speech-Service/includes/containers-cstt-common-run.md
@@ -4,7 +4,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 ---
 
diff --git a/articles/cognitive-services/Speech-Service/includes/containers-speech-config-http.md b/articles/cognitive-services/Speech-Service/includes/containers-speech-config-http.md
@@ -4,14 +4,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 ---
 
-Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK. By default, the Speech SDK uses the public Speech service. To use the container, you need to change the initialization method.
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method.
 
 > [!IMPORTANT]
-> When you use the Speech service with containers, be sure to use host authentication. If you configure the key and region, requests will go to the public Speech service. Results from the Speech service might not be what you expect. Requests from disconnected containers will fail.
+> When you use the Speech service with containers, be sure to use [host authentication](../speech-container-howto.md#host-urls). If you configure the key and region, requests will go to the public Speech service. Results from the Speech service might not be what you expect. Requests from disconnected containers will fail.
 
 ::: zone pivot="programming-language-csharp"
 Instead of using this Azure-cloud initialization config:
diff --git a/articles/cognitive-services/Speech-Service/includes/containers-speech-config-ws.md b/articles/cognitive-services/Speech-Service/includes/containers-speech-config-ws.md
@@ -4,14 +4,14 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: include
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 ---
 
-Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK. By default, the Speech SDK uses the public Speech service. To use the container, you need to change the initialization method.
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method.
 
 > [!IMPORTANT]
-> When you use the Speech service with containers, be sure to use host authentication. If you configure the key and region, requests will go to the public Speech service. Results from the Speech service might not be what you expect. Requests from disconnected containers will fail.
+> When you use the Speech service with containers, be sure to use [host authentication](../speech-container-howto.md#host-urls). If you configure the key and region, requests will go to the public Speech service. Results from the Speech service might not be what you expect. Requests from disconnected containers will fail.
 
 ::: zone pivot="programming-language-csharp"
 Instead of using this Azure-cloud initialization config:
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cli.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cli.md
@@ -37,3 +37,10 @@ spx recognize --file whatstheweatherlike.wav
 > The Speech CLI defaults to English. You can choose a different language [from the speech-to-text table](../../../../language-support.md?tabs=stt). For example, add `--source de-DE` to recognize German speech.
 
 The Speech CLI shows a text transcription of the speech on the screen.
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cpp.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cpp.md
@@ -207,4 +207,11 @@ With [Custom Speech](../../../custom-speech-overview.md), you can upload your ow
 auto speechConfig = SpeechConfig::FromSubscription("YourSubscriptionKey", "YourServiceRegion");
 speechConfig->SetEndpointId("YourEndpointId");
 auto speechRecognizer = SpeechRecognizer::FromConfig(speechConfig);
-```
+```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/csharp.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/csharp.md
@@ -284,6 +284,12 @@ speechConfig.EndpointId = "YourEndpointId";
 var speechRecognizer = new SpeechRecognizer(speechConfig);
 ```
 
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
 ## Change how silence is handled
 
 If a user is expected to speak faster or slower than usual, the default behaviors for non-speech silence in input audio may not result in what you expect. Common problems with silence handling include:
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/go.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/go.md
@@ -180,3 +180,10 @@ go run quickstart
 ```
 
 For detailed information, see the [reference content for the `SpeechConfig` class](https://pkg.go.dev/github.com/Microsoft/cognitive-services-speech-sdk-go@v1.15.0/speech#SpeechConfig) and the [reference content for the `SpeechRecognizer` class](https://pkg.go.dev/github.com/Microsoft/cognitive-services-speech-sdk-go@v1.15.0/speech#SpeechRecognizer).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/java.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/java.md
@@ -226,3 +226,10 @@ SpeechConfig speechConfig = SpeechConfig.FromSubscription("YourSubscriptionKey",
 speechConfig.setEndpointId("YourEndpointId");
 SpeechRecognizer speechRecognizer = new SpeechRecognizer(speechConfig);
 ```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/javascript.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/javascript.md
@@ -206,3 +206,10 @@ var speechConfig = SpeechSDK.SpeechConfig.fromSubscription("YourSubscriptionKey"
 speechConfig.endpointId = "YourEndpointId";
 var speechRecognizer = new SpeechSDK.SpeechRecognizer(speechConfig);
 ```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/objectivec.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/objectivec.md
@@ -29,3 +29,10 @@ SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithS
 speechConfig.endpointId = "YourEndpointId";
 SPXSpeechRecognizer* speechRecognizer = [[SPXSpeechRecognizer alloc] init:speechConfig];
 ```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/python.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/python.md
@@ -173,3 +173,10 @@ speech_config = speechsdk.SpeechConfig(subscription="YourSubscriptionKey", regio
 speech_config.endpoint_id = "YourEndpointId"
 speech_recognizer = speechsdk.SpeechRecognizer(speech_config=speech_config)
 ```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/swift.md b/articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/swift.md
@@ -28,3 +28,10 @@ let speechConfig = SPXSpeechConfiguration(subscription: "YourSubscriptionKey", r
 speechConfig.endpointId = "YourEndpointId";
 let speechRecognizer = SPXSpeechRecognizer(speechConfiguration: speechConfig);
 ```
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/cli.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/cli.md
@@ -35,3 +35,10 @@ spx synthesize --text "I'm excited to try text-to-speech" --audio output greetin
 ```
 
 The Speech CLI will produce natural language in English in the `greetings.wav` audio file.
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/cpp.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/cpp.md
@@ -339,4 +339,11 @@ std::string getEnvironmentVariable(const char* name)
 }
 ```
 
-You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/csharp.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/csharp.md
@@ -300,4 +300,11 @@ class Program
 }
 ```
 
-You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/go.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/go.md
@@ -483,4 +483,11 @@ func main() {
 }
 ```
 
-You can find more text-to-speech samples at [GitHub](https://github.com/microsoft/cognitive-services-speech-sdk-go/tree/master/samples/).
+You can find more text-to-speech samples at [GitHub](https://github.com/microsoft/cognitive-services-speech-sdk-go/tree/master/samples/).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/java.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/java.md
@@ -311,4 +311,11 @@ public class SpeechSynthesis {
 }
 ```
 
-You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/javascript.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/javascript.md
@@ -438,4 +438,11 @@ Here's an example that shows how to subscribe to events for speech synthesis. Yo
 }());
 ```
 
-You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/objectivec.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/objectivec.md
@@ -22,3 +22,9 @@ The [Azure-Samples/cognitive-services-speech-sdk](https://github.com/Azure-Sampl
 * [Synthesize speech in Objective-C on iOS](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/ios/text-to-speech)
 * [Additional samples for Objective-C on iOS](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/samples/objective-c/ios)
 
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/python.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/python.md
@@ -240,4 +240,11 @@ elif speech_synthesis_result.reason == speechsdk.ResultReason.Canceled:
             print("Did you set the speech resource key and region values?")
 ```
 
-You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+You can find more text-to-speech samples at [GitHub](https://aka.ms/csspeech/samples).
+
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
+
diff --git a/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/swift.md b/articles/cognitive-services/Speech-Service/includes/how-to/speech-synthesis/swift.md
@@ -21,4 +21,9 @@ The [Azure-Samples/cognitive-services-speech-sdk](https://github.com/Azure-Sampl
 * [Synthesize speech in Swift on macOS](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/macos/text-to-speech)
 * [Synthesize speech in Swift on iOS](https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/ios/text-to-speech)
 
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+For more information about containers, see the [speech containers](../../../speech-container-howto.md#host-urls) how-to guide.
 
diff --git a/articles/cognitive-services/Speech-Service/language-identification.md b/articles/cognitive-services/Speech-Service/language-identification.md
@@ -1108,6 +1108,15 @@ recognizer.stop_continuous_recognition()
 
 ---
 
+## Run and use a container
+
+Speech containers provide websocket-based query endpoint APIs that are accessed through the Speech SDK and Speech CLI. By default, the Speech SDK and Speech CLI use the public Speech service. To use the container, you need to change the initialization method. Use a container host URL instead of key and region.
+
+When you run language ID in a container, use the `SourceLanguageRecognizer` object instead of `SpeechRecognizer` or `TranslationRecognizer`.
+
+For more information about containers, see the [language identification speech containers](speech-container-lid.md#use-the-container) how-to guide.
+
+
 ::: zone-end
 
 ## Next steps
diff --git a/articles/cognitive-services/Speech-Service/speech-container-configuration.md b/articles/cognitive-services/Speech-Service/speech-container-configuration.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: how-to
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 ---
 
diff --git a/articles/cognitive-services/Speech-Service/speech-container-cstt.md b/articles/cognitive-services/Speech-Service/speech-container-cstt.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: how-to
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 zone_pivot_groups: programming-languages-speech-sdk-cli
 keywords: on-premises, Docker, container
diff --git a/articles/cognitive-services/Speech-Service/speech-container-howto.md b/articles/cognitive-services/Speech-Service/speech-container-howto.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: how-to
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 keywords: on-premises, Docker, container
 ---
@@ -147,8 +147,8 @@ You can have this container and a different Cognitive Services container running
 
 | Protocol | Host URL | Containers |
 |--|--|--|
-| WS | `ws://localhost:5000` | [Speech-to-text](speech-container-stt.md)<br/><br/>[Custom speech-to-text](speech-container-cstt.md)  |
-| HTTP | `http://localhost:5000` | [Neural text-to-speech](speech-container-ntts.md)<br/><br/>[Speech language identification](speech-container-lid.md) |
+| WS | `ws://localhost:5000` | [Speech-to-text](speech-container-stt.md#use-the-container)<br/><br/>[Custom speech-to-text](speech-container-cstt.md#use-the-container)  |
+| HTTP | `http://localhost:5000` | [Neural text-to-speech](speech-container-ntts.md#use-the-container)<br/><br/>[Speech language identification](speech-container-lid.md#use-the-container) |
 
 For more information on using WSS and HTTPS protocols, see [Container security](../cognitive-services-container-support.md#azure-cognitive-services-container-security) in the Azure Cognitive Services documentation.
 
diff --git a/articles/cognitive-services/Speech-Service/speech-container-lid.md b/articles/cognitive-services/Speech-Service/speech-container-lid.md
@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: cognitive-services
 ms.subservice: speech-service
 ms.topic: how-to
-ms.date: 04/06/2023
+ms.date: 04/18/2023
 ms.author: eur
 zone_pivot_groups: programming-languages-speech-sdk-cli
 keywords: on-premises, Docker, container
@@ -121,7 +121,7 @@ Increasing the number of concurrent calls can affect reliability and latency. Fo
 
 [!INCLUDE [Speech container authentication](includes/containers-speech-config-http.md)]
 
-[Try language identification](language-identification.md) using host authentication instead of key and region. Use the `SourceLanguageRecognizer` object instead of `SpeechRecognizer`.
+[Try language identification](language-identification.md) using host authentication instead of key and region. When you run language ID in a container, use the `SourceLanguageRecognizer` object instead of `SpeechRecognizer` or `TranslationRecognizer`.
 
 ## Next steps
 
diff --git a/articles/cognitive-services/Speech-Service/speech-container-ntts.md b/articles/cognitive-services/Speech-Service/speech-container-ntts.md
diff --git a/articles/cognitive-services/Speech-Service/speech-container-overview.md b/articles/cognitive-services/Speech-Service/speech-container-overview.md
diff --git a/articles/cognitive-services/Speech-Service/speech-container-stt.md b/articles/cognitive-services/Speech-Service/speech-container-stt.md
