dictation mode to dpp

Author: eric-urban

articles/cognitive-services/Speech-Service/display-text-format.md

@@ -60,6 +60,60 @@ You don't have to speak every punctuation mark out loud. Speech-to-text automati
 |how are you|How are you?|
 |we can go to the mall park or beach|We can go to the mall, park, or beach.|
 
+## Explicit Punctuation 
+
+You can configure speech-to-text to recognize explicit punctuation marks. Then you can speak punctuation aloud in order to make your text more legible. This is especially useful in a situation where you want to use complex punctuation without having to merge it later. Some examples are shown in this table.
+
+|Recognized speech|Display text|
+|---|---|
+|they entered the room dot dot dot|They entered the room...|
+|i heart emoji you period|I <3 you.|
+|the options are apple forward slash banana forward slash orange period|The options are apple/banana/orange.|
+|are you sure question mark|Are you sure?|
+
+Use the Speech SDK to enable dictation mode when you're using speech-to-text with continuous recognition. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation.
+
+::: zone pivot="programming-language-csharp"
+```csharp
+speechConfig.EnableDictation();
+```
+::: zone-end
+::: zone pivot="programming-language-cpp"
+```cpp
+speechConfig->EnableDictation();
+```
+::: zone-end
+::: zone pivot="programming-language-go"
+```go
+speechConfig.EnableDictation()
+```
+::: zone-end
+::: zone pivot="programming-language-java"
+```java
+speechConfig.enableDictation();
+```
+::: zone-end
+::: zone pivot="programming-language-javascript"
+```javascript
+speechConfig.enableDictation();
+```
+::: zone-end
+::: zone pivot="programming-language-objectivec"
+```objective-c
+[self.speechConfig enableDictation];
+```
+::: zone-end
+::: zone pivot="programming-language-swift"
+```swift
+self.speechConfig!.enableDictation()
+```
+::: zone-end
+::: zone pivot="programming-language-python"
+```python
+speech_config.enable_dictation()
+```
+::: zone-end
+
 ## Profanity filter 
 
 You can specify whether to mask, remove, or show profanity in the final transcribed text. Masking replaces profane words with asterisk (*) characters so that you can keep the original sentiment of your text while making it more appropriate for certain situations 

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/cpp.md

@@ -183,16 +183,6 @@ recognitionEnd.get_future().get();
 recognizer->StopContinuousRecognitionAsync().get();
 ```
 
-## Dictation mode
-
-When you're using continuous recognition, you can enable dictation processing by using the corresponding function. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation. For example, the utterance "Do you live in town question mark" would be interpreted as the text "Do you live in town?".
-
-To enable dictation mode, use the [`EnableDictation`](/cpp/cognitive-services/speech/speechconfig#enabledictation) method on [`SpeechConfig`](/cpp/cognitive-services/speech/speechconfig):
-
-```cpp
-config->EnableDictation();
-```
-
 ## Change the source language
 
 A common task for speech recognition is specifying the input (or source) language. The following example shows how you would change the input language to German. In your code, find your [`SpeechConfig`](/cpp/cognitive-services/speech/speechconfig) instance and add this line directly below it:

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/csharp.md

@@ -258,16 +258,6 @@ Task.WaitAny(new[] { stopRecognition.Task });
 // await recognizer.StopContinuousRecognitionAsync();
 ```
 
-### Dictation mode
-
-When you're using continuous recognition, you can enable dictation processing by using the corresponding function. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation. For example, the utterance "Do you live in town question mark" would be interpreted as the text "Do you live in town?".
-
-To enable dictation mode, use the [`EnableDictation`](/dotnet/api/microsoft.cognitiveservices.speech.speechconfig.enabledictation) method on [`SpeechConfig`](/dotnet/api/microsoft.cognitiveservices.speech.speechconfig):
-
-```csharp
-speechConfig.EnableDictation();
-```
-
 ## Change the source language
 
 A common task for speech recognition is specifying the input (or source) language. The following example shows how you would change the input language to Italian. In your code, find your [`SpeechConfig`](/dotnet/api/microsoft.cognitiveservices.speech.speechconfig) instance and add this line directly below it:

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/java.md

@@ -201,16 +201,6 @@ stopTranslationWithFileSemaphore.acquire();
 recognizer.stopContinuousRecognitionAsync().get();
 ```
 
-### Dictation mode
-
-When you're using continuous recognition, you can enable dictation processing by using the corresponding function. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation. For example, the utterance "Do you live in town question mark" would be interpreted as the text "Do you live in town?".
-
-To enable dictation mode, use the [`enableDictation`](/java/api/com.microsoft.cognitiveservices.speech.speechconfig.enabledictation) method on [`SpeechConfig`](/java/api/com.microsoft.cognitiveservices.speech.speechconfig):
-
-```java
-config.enableDictation();
-```
-
 ## Change the source language
 
 A common task for speech recognition is specifying the input (or source) language. The following example shows how you would change the input language to French. In your code, find your [`SpeechConfig`](/java/api/com.microsoft.cognitiveservices.speech.speechconfig) instance and add this line directly below it:

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/javascript.md

@@ -181,16 +181,6 @@ recognizer.startContinuousRecognitionAsync();
 // recognizer.stopContinuousRecognitionAsync();
 ```
 
-### Dictation mode
-
-When you're using continuous recognition, you can enable dictation processing by using the corresponding function. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation. For example, the utterance "Do you live in town question mark" would be interpreted as the text "Do you live in town?".
-
-To enable dictation mode, use the [`enableDictation`](/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig#enabledictation--) method on [`SpeechConfig`](/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig):
-
-```javascript
-speechConfig.enableDictation();
-```
-
 ## Change the source language
 
 A common task for speech recognition is specifying the input (or source) language. The following example shows how you would change the input language to Italian. In your code, find your [`SpeechConfig`](/javascript/api/microsoft-cognitiveservices-speech-sdk/speechconfig) instance and add this line directly below it:

articles/cognitive-services/Speech-Service/includes/how-to/recognize-speech/python.md

@@ -148,16 +148,6 @@ while not done:
     time.sleep(.5)
 ```
 
-### Dictation mode
-
-When you're using continuous recognition, you can enable dictation processing by using the corresponding function. This mode will cause the speech configuration instance to interpret word descriptions of sentence structures such as punctuation. For example, the utterance "Do you live in town question mark" would be interpreted as the text "Do you live in town?".
-
-To enable dictation mode, use the [`enable_dictation()`](/python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.speechconfig#enable-dictation--) method on [`SpeechConfig`](/python/api/azure-cognitiveservices-speech/azure.cognitiveservices.speech.speechconfig):
-
-```Python 
-SpeechConfig.enable_dictation()
-```
-
 ## Change the source language
 
 A common task for speech recognition is specifying the input (or source) language. The following example shows how you would change the input language to German. In your code, find your `SpeechConfig` instance and add this line directly below it: