Merge pull request #284398 from solarrezaei11/solarworkingbranch

Add link to Python GitHub code and reference to Transcriptions_Create examples.

Author: prmerger-automator[bot]

articles/ai-services/speech-service/batch-transcription-create.md

@@ -108,6 +108,10 @@ You can query the status of your transcriptions with the [Transcriptions_Get](/r
 Call [Transcriptions_Delete](/rest/api/speechtotext/transcriptions/delete)
 regularly from the service, after you retrieve the results. Alternatively, set the `timeToLive` property to ensure the eventual deletion of the results.
 
+> [!TIP]
+> You can also try the Batch Transcription API using Python on [GitHub](https://github.com/Azure-Samples/cognitive-services-speech-sdk/blob/master/samples/batch/python/python-client/main.py).
+
+
 ::: zone-end
 
 ::: zone pivot="speech-cli"
@@ -168,7 +172,7 @@ spx help batch transcription
 
 ::: zone pivot="rest-api"
 
-Here are some property options that you can use to configure a transcription when you call the [Transcriptions_Create](/rest/api/speechtotext/transcriptions/create) operation.
+Here are some property options to configure a transcription when you call the [Transcriptions_Create](/rest/api/speechtotext/transcriptions/create) operation. You can find more examples on the same page, such as [creating a transcription with language identification](/rest/api/speechtotext/transcriptions/create/#create-a-transcription-with-language-identification).
 
 | Property | Description |
 |----------|-------------|

articles/ai-services/speech-service/includes/how-to/speech-synthesis/python.md

@@ -36,6 +36,15 @@ The voice that speaks is determined in order of priority as follows:
 - If both `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` are set, the `SpeechSynthesisLanguage` setting is ignored. The voice that you specify by using `SpeechSynthesisVoiceName` speaks.
 - If the voice element is set by using [Speech Synthesis Markup Language (SSML)](../../../speech-synthesis-markup.md), the `SpeechSynthesisVoiceName` and `SpeechSynthesisLanguage` settings are ignored.
 
+In summary, the order of priority can be described as:
+
+| `SpeechSynthesisVoiceName` | `SpeechSynthesisLanguage` | SSML | Outcome |
+|:----------------------------:|:----------------------------:|:--------:|---------------------------------------------------------|
+| ✗ | ✗ | ✗ | Default voice for `en-US` speaks |
+| ✗ | ✔ | ✗ | Default voice for specified locale speaks. |
+| ✔ | ✔ | ✗ | The voice that you specify by using `SpeechSynthesisVoiceName` speaks. |
+| ✔| ✔ | ✔ | The voice that you specify by using SSML speaks. |
+
 ## Synthesize speech to a file
 
 Create a [SpeechSynthesizer](/python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.speechsynthesizer) object. This object runs text to speech conversions and outputs to speakers, files, or other output streams. `SpeechSynthesizer` accepts as parameters:
@@ -53,7 +62,8 @@ Create a [SpeechSynthesizer](/python/api/azure-cognitiveservices-speech/azure.co
 
    ```python
    speech_synthesizer = speechsdk.SpeechSynthesizer(speech_config=speech_config, audio_config=audio_config)
-   speech_synthesizer.speak_text_async("I'm excited to try text to speech")
+   speech_synthesis_result = speech_synthesizer.speak_text_async("I'm excited to try text to speech").get()
+    
    ```
 
 When you run the program, it creates a synthesized *.wav* file, which is written to the location that you specify. This result is a good example of the most basic usage. Next, you can customize output and handle the output response as an in-memory stream for working with custom scenarios.
@@ -85,8 +95,8 @@ In this example, use the `AudioDataStream` constructor to get a stream from the
 
 ```python
 speech_synthesizer = speechsdk.SpeechSynthesizer(speech_config=speech_config, audio_config=None)
-result = speech_synthesizer.speak_text_async("I'm excited to try text to speech").get()
-stream = speechsdk.AudioDataStream(result)
+speech_synthesis_result = speech_synthesizer.speak_text_async("I'm excited to try text to speech").get()
+stream = speechsdk.AudioDataStream(speech_synthesis_result)
 ```
 
 At this point, you can implement any custom behavior by using the resulting `stream` object.
@@ -112,8 +122,8 @@ This example specifies the high-fidelity RIFF format `Riff24Khz16BitMonoPcm` by
 speech_config.set_speech_synthesis_output_format(speechsdk.SpeechSynthesisOutputFormat.Riff24Khz16BitMonoPcm)
 speech_synthesizer = speechsdk.SpeechSynthesizer(speech_config=speech_config, audio_config=None)
 
-result = speech_synthesizer.speak_text_async("I'm excited to try text to speech").get()
-stream = speechsdk.AudioDataStream(result)
+speech_synthesis_result = speech_synthesizer.speak_text_async("I'm excited to try text to speech").get()
+stream = speechsdk.AudioDataStream(speech_synthesis_result)
 stream.save_to_wav_file("path/to/write/file.wav")
 ```
 
@@ -146,9 +156,9 @@ To start using SSML for customization, make a minor change that switches the voi
    speech_synthesizer = speechsdk.SpeechSynthesizer(speech_config=speech_config, audio_config=None)
 
    ssml_string = open("ssml.xml", "r").read()
-   result = speech_synthesizer.speak_ssml_async(ssml_string).get()
+   speech_synthesis_result = speech_synthesizer.speak_ssml_async(ssml_string).get()
 
-   stream = speechsdk.AudioDataStream(result)
+   stream = speechsdk.AudioDataStream(speech_synthesis_result)
    stream.save_to_wav_file("path/to/write/file.wav")
    ```