Merge pull request #220251 from valindrae/docs-fixes

Docs fixes

Author: prmerger-automator[bot]

articles/communication-services/how-tos/call-automation/includes/recognize-action-quickstart-csharp.md

@@ -16,7 +16,6 @@ ms.author: kpunjabi
 - Azure Communication Services resource. See [Create an Azure Communication Services resource](../../../quickstarts/create-communication-resource.md?tabs=windows&pivots=platform-azp). Note the connection string for this resource. 
 - Create a new web service application using the [Call Automation SDK](../../../quickstarts/call-automation/callflows-for-customer-interactions.md).
 - The latest [.NET library](https://dotnet.microsoft.com/download/dotnet-core) for your operating system.
-- [Apache Maven](https://maven.apache.org/download.cgi).
 - Obtain the NuGet package from the [Azure SDK Dev Feed](https://github.com/Azure/azure-sdk-for-net/blob/main/CONTRIBUTING.md#nuget-package-dev-feed)
 
 ## Technical specifications
@@ -27,11 +26,11 @@ The following parameters are available to customize the Recognize function:
 | ------- |--| ------------------------ | --------- | ------------------ |
 | Prompt <br/><br/> *(for details on Play action, refer to [this how-to guide](../play-action.md))* | FileSource | Not set |This will be the message you wish to play before recognizing input. | Optional |
 | InterToneTimeout | TimeSpan | 2 seconds <br/><br/>**Min:** 1 second <br/>**Max:** 60 seconds | Limit in seconds that ACS will wait for the caller to press another digit (inter-digit timeout). | Optional |
-| InitialSilenceTimeout | TimeSpan | 5seconds<br/><br/>**Min:** 0 seconds <br/>**Max:** 300 seconds | How long recognize action will wait for input before considering it a timeout. | Optional |
+| InitialSilenceTimeout | TimeSpan | 5 seconds<br/><br/>**Min:** 0 seconds <br/>**Max:** 300 seconds | How long recognize action will wait for input before considering it a timeout. | Optional |
 | MaxTonesToCollect | Integer | No default<br/><br/>**Min:** 1|Number of digits a developer expects as input from the participant.| Required |
 | StopTones |IEnumeration\<DtmfTone\> | Not set | The digit participants can press to escape out of a batch DTMF event. | Optional |
 | InterruptPrompt | Bool | True | If the participant has the ability to interrupt the playMessage by pressing a digit. | Optional |
-| InterruptCallMediaOperation | Bool | True | If this flag is set it will interrupt the current call media operation if any (for example if play is going on) and initiate recognize. | Optional |
+| InterruptCallMediaOperation | Bool | True | If this flag is set it will interrupt the current call media operation. For example if any audio is being played it will interrupt that operation and initiate recognize. | Optional |
 | OperationContext | String | Not set | String that developers can pass mid action, useful for allowing developers to store context about the events they receive. | Optional |
 
 ## Create a new C# application
@@ -73,7 +72,7 @@ var targetParticipant = new PhoneNumberIdentifier("+1XXXXXXXXXXX");
 
 ## Receiving recognize event updates
 
-Developers can subscribe to the *RecognizeCompleted* and *RecognizeFailed* events on the webhook callback they registered for the call to create business logic in their application for determining next steps when one of the aforementioned events occurs. 
+Developers can subscribe to the *RecognizeCompleted* and *RecognizeFailed* events on the webhook callback they registered for the call to create business logic in their application for determining next steps when one of the previously mentioned events occurs. 
 
 Example of *RecognizeCompleted* event:
 ``` json

articles/communication-services/samples/call-automation-appointment-reminder.md

@@ -20,12 +20,11 @@ zone_pivot_groups: acs-csharp-java
 
 This Azure Communication Services Call Automation - Appointment Reminder sample demonstrates how your application can use the Call Automation SDK to build automated workflows that create outbound calls to proactively reach out to your customers. 
 
-> [Note]
 > This sample is available **on GitHub** for [C#](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/CallAutomation_AppointmentReminder) and [Java](https://github.com/Azure-Samples/communication-services-java-quickstarts/tree/main/CallAutomation_AppointmentReminder)
 
 ## Overview
 
-This sample application makes an outbound call to a phone number then performs dtmf recognition and then plays the next audio file based on the key pressed by the callee. This sample application accepts tone 1 (tone1) and 2 (tone2). If the callee presses any key other than what it is expecting, an invalid audio tone will be played and then the call will be disconnected.
+This sample application makes an outbound call to a phone number then performs dtmf recognition and then plays the next audio file based on the key pressed by the callee. This sample application accepts tone 1 (tone1) and 2 (tone2). If the callee presses any key other than what it's expecting, an invalid audio tone will be played and then the call will be disconnected.
 
 This sample application is also capable of making multiple concurrent outbound calls.
 

articles/communication-services/samples/includes/ca-appointment-reminder-csharp.md

@@ -38,14 +38,14 @@ ms.author: kpunjabi
 Open the appsetting.json file to configure the following settings
 
 1. `ConnectionString`: Azure Communication Service resource's connection string.
-2. `SourcePhone`: Phone number associated with the Azure Communication Service resource. For example "+1425XXXAAAA"
-3. `TargetPhoneNumber`: Target phone number to add in the call. For example "+1425XXXAAAA"
+2. `SourcePhone`: Phone number associated with the Azure Communication Service resource. For example, "+1425XXXAAAA"
+3. `TargetPhoneNumber`: Target phone number to add in the call. For example, "+1425XXXAAAA"
 4. `AppBaseUri`: Base url of the app. (For local development replace the dev tunnel url)
 
 ### Run app locally
 
 1. Run the `CallAutomation_AppointmentReminder` project in debug mode
-2. Browser should pop up with swagger UI. If using Visual studio dev tunnels note the app base url and update it in the appsetting.json file `(AppBaseUri)`
+2. Browser should pop up with swagger UI. If you're using Visual Studio dev tunnels note the app base url and update it in the appsetting.json file `(AppBaseUri)`
 3. To initiate the call, from the swagger ui execute the `/api/call` endpoint or make an Http post request to `https://<AppBaseUri>/api/call`
 
 ### Publish the Call Automation Appointment Reminder to Azure WebApp
@@ -54,7 +54,7 @@ Open the appsetting.json file to configure the following settings
 2. Create a new publish profile and select your app name, Azure subscription, resource group etc. (choose any unique name, as this URL needed for `AppBaseUri` configuration settings)
 3. After publishing, add the following configurations on Azure portal (under app service's configuration section)
 	1. `ConnectionString`: Azure Communication Service resource's connection string.
-	2. `SourcePhone`: Phone number associated with the Azure Communication Service resource. For example "+1425XXXAAAA"
-	3. `TargetPhoneNumber`: Target phone number to add in the call. For example "+1425XXXAAAA"
+	2. `SourcePhone`: Phone number associated with the Azure Communication Service resource. For example, "+1425XXXAAAA"
+	3. `TargetPhoneNumber`: Target phone number to add in the call. For example, "+1425XXXAAAA"
     4. `AppBaseUri`:  URI of the deployed app service.
 4. Detailed instructions on publishing the app to Azure are available at [Publish a Web app](/visualstudio/deployment/quickstart-deploy-aspnet-web-app?view=vs-2019&tabs=azure&preserve-view=true)

articles/communication-services/samples/includes/ca-appointment-reminder-java.md

@@ -33,7 +33,7 @@ ms.author: kpunjabi
     - `ConnectionString`: Azure Communication Service resource's connection string.
     - `SourcePhone`: Phone number associated with the Azure Communication Service resource.
     - `DestinationIdentity`: Target Phone number.
-    - `Format`: "OutboundTarget(Phone Number)". For e.g. "+1425XXXAAAA"
+    - `Format`: "OutboundTarget(Phone Number)". For example, "+1425XXXAAAA"
     - `CallbackUrl`: Ngrok Forwarding URL.
     - `CognitiveServiceKey`: (Optional) Cognitive service key used for generating custom messages.
     - `CognitiveServiceRegion`: (Optional) Region associated with cognitive service.