Edits and Acrolinx

Made all include files consistent, ran Acrolinx, made text edits.

Author: vac0224

articles/communication-services/quickstarts/voice-video-calling/includes/call-recording-samples/call-recording-csharp.md

@@ -48,9 +48,9 @@ CallAutomationClient callAutomationClient = new CallAutomationClient("<ACSConnec
 ## 2. Start recording session with StartRecordingOptions using 'StartAsync' API
 
 Use the `serverCallId` received during initiation of the call.
-- Use `RecordingContent` to pass the recording content type. Use `audio`.
-- Use `RecordingChannel` to pass the recording channel type. Use `mixed` or `unmixed`.
-- Use `RecordingFormat` to pass the format of the recording. Use `wav`.
+- Use `RecordingContent` to pass the recording content type. Use `AUDIO`.
+- Use `RecordingChannel` to pass the recording channel type. Use `MIXED` or `UNMIXED`.
+- Use `RecordingFormat` to pass the format of the recording. Use `WAV`.
 
 ```csharp
 StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>")) 
@@ -63,9 +63,9 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
 Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording()
 .StartAsync(recordingOptions);
 ```
-### 2.1. Start Recording  - Bring Your Own Azure Blob Store
+### 2.1. Start Recording - Bring Your Own Azure Blob Store
 
-To store the recording file when recording is complete, start recording with your own Azure Blob Storage defined.
+Start recording using your designated Azure Blob Storage to store the recorded file once recording is complete.
 
 ```csharp
 StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>"))
@@ -80,9 +80,12 @@ StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCal
 Response<RecordingStateResult> response = await callAutomationClient.GetCallRecording()
 .StartAsync(recordingOptions);
 ```
+
 ## 2.2. Start recording session with Pause mode enabled using 'StartAsync' API
+
 > [!NOTE]
 > **Recordings will need to be resumed for recording file to be generated.**
+
 ```csharp
 StartRecordingOptions recordingOptions = new StartRecordingOptions(new ServerCallLocator("<ServerCallId>")) 
 {
@@ -97,6 +100,7 @@ Response<RecordingStateResult> response = await callAutomationClient.GetCallReco
 ```
 
 ### 2.3. Only for Unmixed - Specify a user on channel 0
+
 To produce unmixed audio recording files, you can use the `AudioChannelParticipantOrdering` functionality to specify which user you want to record on channel 0. The rest of the participants are assigned to a channel as they speak. If you use `RecordingChannel.Unmixed` but don't use `AudioChannelParticipantOrdering`, Call Recording assigns channel 0 to the first participant speaking. 
 
 ```csharp
@@ -131,29 +135,29 @@ The `StartAsync` API response contains the `recordingId` of the recording sessio
 
 ## 3. Stop recording session using `StopAsync` API
 
-Use the `recordingId` received in response of `StartAsync`.
+Use the `recordingId` received in response to `StartAsync`.
 
 ```csharp
 var stopRecording = await callAutomationClient.GetCallRecording().StopAsync(recordingId);
 ```
 
 ## 4. Pause recording session using `PauseAsync` API
 
-Use the `recordingId` received in response of `StartAsync`.
+Use the `recordingId` received in response to `StartAsync`.
 
 ```csharp
 var pauseRecording = await callAutomationClient.GetCallRecording ().PauseAsync(recordingId);
 ```
 
 ## 5. Resume recording session using `ResumeAsync` API
 
-Use the `recordingId` received in response of `StartAsync`.
+Use the `recordingId` received in response to `StartAsync`.
 
 ```csharp
 var resumeRecording = await callAutomationClient.GetCallRecording().ResumeAsync(recordingId);
 ```
 
-## 6.	Download recording File using `DownloadToAsync` API
+## 6. Download recording File using `DownloadToAsync` API
 
 Use an [Azure Event Grid](../../../../../event-grid/event-schema-communication-services.md) web hook or other triggered action to notify your services when the recorded media is ready for download.
 
@@ -197,11 +201,11 @@ var recordingDownloadUri = new Uri(contentLocation);
 var response = await callAutomationClient.GetCallRecording().DownloadToAsync(recordingDownloadUri, fileName);
 ```
 
-Fetch the `downloadLocation` for the recording from the `contentLocation` attribute of the `recordingChunk`. `DownloadToAsync` method downloads the content into provided filename.
+Fetch the `downloadLocation` for the recording from the `contentLocation` attribute of the `recordingChunk`. Use the `DownloadToAsync` method to download the content into a provided filename.
 
 ## 7. Delete recording content using `DeleteAsync` API
 
-Use `DeleteAsync` API to delete the recording content (such as recorded media and metadata)
+Use `DeleteAsync` API to delete the recording content (such as recorded media and metadata).
 
 ```csharp
 var recordingDeleteUri = new Uri(deleteLocation);

articles/communication-services/quickstarts/voice-video-calling/includes/call-recording-samples/call-recording-java.md

@@ -68,9 +68,9 @@ Response<RecordingStateResult> response = callAutomationClient.getCallRecording(
 
 ```
 
-### 2.1. Start Recording  - Bring Your Own Azure Blob Store
+### 2.1. Start Recording - Bring Your Own Azure Blob Store
 
-To store the recording file when recording is complete, start the recording session with your own Azure Blob Storage.
+Start recording using your designated Azure Blob Storage to store the recorded file once recording is complete.
 
 ```java
         StartRecordingOptions recordingOptions = new StartRecordingOptions(callLocator)
@@ -203,14 +203,13 @@ The following code is an example of the event schema.
 }
 ```
 
-Use `downloadToWithResponse` method of `CallRecording` class for downloading the recorded media. Following are the supported parameters for `downloadToWithResponse` method:
+Use `downloadToWithResponse` method of `CallRecording` class to download the recorded media. Following are the supported parameters for `downloadToWithResponse` method:
 - `contentLocation`: Azure Communication Services URL where the content is located.
 - `destinationPath` : File location.
 - `parallelDownloadOptions`: An optional `ParallelDownloadOptions` object to modify how the parallel download works.
 - `overwrite`: True to overwrite the file if it exists.
 - `context`: A Context representing the request context.
 
-
 ```java
 Boolean overwrite = true;
 ParallelDownloadOptions parallelDownloadOptions = null;

articles/communication-services/quickstarts/voice-video-calling/includes/call-recording-samples/call-recording-javascript.md

@@ -21,24 +21,24 @@ You can download the sample app from [GitHub](https://github.com/Azure-Samples/c
 Call Recording APIs use exclusively the `serverCallId`to initiate recording. There are a couple of methods you can use to fetch the `serverCallId` depending on your scenario:
 
 ### Call Automation scenarios
+
 - When using [Call Automation](../../../call-automation/callflows-for-customer-interactions.md), you have two options to get the `serverCallId`:
-    1) Once a call is created, a `serverCallId` is returned as a property of the `CallConnected` event after a call has been established. Learn how to [Get CallConnected event](../../../call-automation/callflows-for-customer-interactions.md?pivots=programming-language-javascript#update-programcs) from Call Automation SDK.
-    2) Once you answer the call or a call is created the `serverCallId` is returned as a property of the `AnswerCallResult` or `CreateCallResult` API responses respectively.
+    1) Once a call is created, a `serverCallId` is returned as a property of the `CallConnected` event after a call is established. Learn how to [Get a CallConnected event](../../../call-automation/callflows-for-customer-interactions.md?pivots=programming-language-javascript#update-programcs) from the Call Automation SDK.
+    2) Once you answer the call or a call is created, it returns the `serverCallId` as a property of the `AnswerCallResult` or `CreateCallResult` API responses respectively.
 
 ### Calling SDK scenarios
-- When using [Calling Client SDK](../../get-started-with-video-calling.md), you can retrieve the `serverCallId` by using the `getServerCallId` method on the call.
-Use this example to learn how to [Get serverCallId](../../get-server-call-id.md) from the Calling Client SDK.
 
+When using [Calling Client SDK](../../get-started-with-video-calling.md), you can retrieve the `serverCallId` by using the `getServerCallId` method on the call.
 
+Use this example to learn how to [Get a serverCallId](../../get-server-call-id.md) from the Calling Client SDK.
 
 Let's get started with a few simple steps!
 
-
-
 ## 1. Create a Call Automation client
 
 Call Recording APIs are part of the Azure Communication Services [Call Automation](../../../../concepts/call-automation/call-automation.md) libraries. Thus, it's necessary to create a Call Automation client.
-To create a call automation client, you'll use your Communication Services connection string and pass it to `CallAutomationClient` object.
+
+To create a call automation client, use your Communication Services connection string and pass it to `CallAutomationClient` object.
 
 ```javascript
 const callAutomationClient = new CallAutomationClient.CallAutomationClient("<ACSConnectionString>");
@@ -47,9 +47,9 @@ const callAutomationClient = new CallAutomationClient.CallAutomationClient("<ACS
 ## 2. Start recording session with StartRecordingOptions using 'StartAsync' API
 
 Use the `serverCallId` received during initiation of the call.
-- RecordingContent is used to pass the recording content type. Use audio
-- RecordingChannel is used to pass the recording channel type. Use mixed or unmixed.
-- RecordingFormat is used to pass the format of the recording. Use wav.
+- Use `RecordingContent` to pass the recording content type. Use `AUDIO`.
+- Use `RecordingChannel` to pass the recording channel type. Use `MIXED` or `UNMIXED`.
+- Use `RecordingFormat` to pass the format of the recording. Use `WAV`.
 
 ```javascript
 var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };
@@ -65,8 +65,9 @@ var options: StartRecordingOptions =
 var response = await callAutomationClient.getCallRecording().start(options);
 ```
 
-### 2.1. Start Recording  - Bring Your Own Azure Blob Store
-Start Recording with your own Azure Blob Storage defined to store the recording file once recording is complete.
+### 2.1. Start Recording - Bring Your Own Azure Blob Store
+
+Start recording using your designated Azure Blob Storage to store the recorded file once recording is complete.
 
 ```javascript
 const recordingStorageKind: RecordingStorageKind = "azureBlobStorage"
@@ -104,7 +105,7 @@ var response = await callAutomationClient.getCallRecording().start(options);
 ```
 
 ### 2.3. Only for Unmixed - Specify a user on channel 0
-To produce unmixed audio recording files, you can use the `AudioChannelParticipantOrdering` functionality to specify which user you want to record on channel 0. The rest of the participants will be assigned to a channel as they speak. If you use `RecordingChannel.Unmixed` but don't use `AudioChannelParticipantOrdering`, Call Recording will assign channel 0 to the first participant speaking.
+To produce unmixed audio recording files, you can use the `AudioChannelParticipantOrdering` functionality to specify which user you want to record on channel 0. The rest of the participants are assigned to a channel as they speak. If you use `RecordingChannel.Unmixed` but don't use `AudioChannelParticipantOrdering`, Call Recording assigns channel 0 to the first participant speaking.
 
 ```javascript
 var locator: CallLocator = { id: "<ServerCallId>", kind: "serverCallLocator" };
@@ -145,23 +146,23 @@ The `StartAsync` API response contains the `recordingId` of the recording sessio
 
 ## 3.	Stop recording session using 'stop' API
 
-Use the `recordingId` received in response of `start`.
+Use the `recordingId` received in response to `start`.
 
 ```javascript
 var stopRecording = await callAutomationClient.getCallRecording().stop(recordingId);
 ```
 
 ## 4.	Pause recording session using 'pause' API
 
-Use the `recordingId` received in response of `start`.
+Use the `recordingId` received in response to `start`.
 
 ```javascript
 var pauseRecording = await callAutomationClient.getCallRecording().pause(recordingId);
 ```
 
 ## 5.	Resume recording session using 'ResumeAsync' API
 
-Use the `recordingId` received in response of `start`.
+Use the `recordingId` received in response to `start`.
 
 ```javascript
 var resumeRecording = await callAutomationClient.getCallRecording().resume(recordingId);
@@ -171,9 +172,9 @@ var resumeRecording = await callAutomationClient.getCallRecording().resume(recor
 
 Use an [Azure Event Grid](../../../../../event-grid/event-schema-communication-services.md) web hook or other triggered action should be used to notify your services when the recorded media is ready for download.
 
-An Event Grid notification `Microsoft.Communication.RecordingFileStatusUpdated` is published when a recording is ready for retrieval, typically a few minutes after the recording process has completed (for example, meeting ended, recording stopped). Recording event notifications include `contentLocation` and `metadataLocation`, which are used to retrieve both recorded media and a recording metadata file.
+An Event Grid notification `Microsoft.Communication.RecordingFileStatusUpdated` is published when a recording is ready for retrieval, typically a few minutes after the recording process completes (such as the meeting ended or the recording stopped). Recording event notifications include `contentLocation` and `metadataLocation`, which are used to retrieve both recorded media and a recording metadata file.
 
-Below is an example of the event schema.
+The following code is an example of the event schema.
 
 ```
 {
@@ -204,12 +205,12 @@ Below is an example of the event schema.
 }
 ```
 
-Use `downloadToPath` API for downloading the recorded media.
+Use `downloadToPath` API to download the recorded media.
 
 ```javascript
 var response = await callAutomationClient.getCallRecording().downloadToPath(contentLocation, fileName);
 ```
-The `downloadLocation` for the recording can be fetched from the `contentLocation` attribute of the `recordingChunk`. `DownloadToAsync` method download the content into provided filename.
+The `downloadLocation` for the recording can be fetched from the `contentLocation` attribute of the `recordingChunk`. Use the `DownloadToAsync` method to download the content into a provided filename.
 
 ## 7. Delete recording content using 'DeleteAsync' API