two-communication-services-articles

Author: ShawnJackson

articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-android.md

@@ -8,7 +8,7 @@ ms.author: rifox
 
 ## Install the SDK
 
-Locate your project-level *build.gradle* file and add `mavenCentral()` to the list of repositories under `buildscript` and `allprojects`:
+Locate your project-level `build.gradle` file and add `mavenCentral()` to the list of repositories under `buildscript` and `allprojects`:
 
 ```groovy
 buildscript {
@@ -30,7 +30,7 @@ allprojects {
 }
 ```
 
-Then, in your module-level *build.gradle* file, add the following lines to the `dependencies` section:
+Then, in your module-level `build.gradle` file, add the following lines to the `dependencies` section:
 
 ```groovy
 dependencies {
@@ -40,7 +40,7 @@ dependencies {
 }
 ```
 
-### Initialize the required objects
+## Initialize the required objects
 
 To create a `CallAgent` instance, you have to call the `createCallAgent` method on a `CallClient` instance. This call asynchronously returns a `CallAgent` instance object.
 

articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-ios.md

@@ -34,7 +34,7 @@ You're not going to create tests during this quickstart. Feel free to clear the
 
 To access the device's microphone, you need to update your app's information property list by using `NSMicrophoneUsageDescription`. You set the associated value to a string that will be included in the dialog that the system uses to request access from the user.
 
-Right-click the *Info.plist* entry of the project tree, and then select **Open As** > **Source Code**. Add the following lines in the top-level `<dict>` section, and then save the file.
+Right-click the **Info.plist** entry of the project tree, and then select **Open As** > **Source Code**. Add the following lines in the top-level `<dict>` section, and then save the file.
 
 ```xml
 <key>NSMicrophoneUsageDescription</key>
@@ -43,14 +43,14 @@ Right-click the *Info.plist* entry of the project tree, and then select **Open A
 
 ### Set up the app framework
 
-Open your project's *ContentView.swift* file. Add an `import` declaration to the top of the file to import the `AzureCommunicationCalling` library. In addition, import `AVFoundation`. You'll need it for audio permission requests in the code.
+Open your project's `ContentView.swift` file. Add an `import` declaration to the top of the file to import the `AzureCommunicationCalling` library. In addition, import `AVFoundation`. You'll need it for audio permission requests in the code.
 
 ```swift
 import AzureCommunicationCalling
 import AVFoundation
 ```
 
-## Initialize CallAgent
+### Initialize CallAgent
 
 To create a `CallAgent` instance from `CallClient`, you have to use a `callClient.createCallAgent` method that asynchronously returns a `CallAgent` object after it's initialized.
 

articles/communication-services/how-tos/calling-sdk/includes/install-sdk/install-sdk-windows.md

@@ -9,7 +9,7 @@ ms.author: jowang
 
 ### Create the Visual Studio project
 
-For a UWP app, in Visual Studio 2022, create a new **Blank App (Universal Windows)** project. After you enter the project name, feel free to choose any Windows SDK later than 10.0.17763.0.
+For a Universal Windows Platform (UWP) app, in Visual Studio 2022, create a new **Blank App (Universal Windows)** project. After you enter the project name, feel free to choose any Windows SDK later than 10.0.17763.0.
 
 For a WinUI 3 app, create a new project with the **Blank App, Packaged (WinUI 3 in Desktop)** template to set up a single-page WinUI 3 app. [Windows App SDK version 1.3](/windows/apps/windows-app-sdk/stable-channel#version-13) or later is required.
 

articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-android.md

@@ -42,7 +42,7 @@ implementation 'com.google.firebase:firebase-core:16.0.8'
 implementation 'com.google.firebase:firebase-messaging:20.2.4'
 ```
 
-In your project level's *build.gradle* file, add the following line in the `dependencies` section if it's not already there:
+In your project level's `build.gradle` file, add the following line in the `dependencies` section if it's not already there:
 
 ```groovy
 classpath 'com.google.gms:google-services:4.3.3'

articles/communication-services/how-tos/calling-sdk/includes/push-notifications/push-notifications-windows.md

@@ -86,7 +86,7 @@ Before you start the tasks of registering for, handling, and showing a Windows n
    }
    ```
 
-### Register for push notifications
+## Register for push notifications
 
 To register for push notifications, call `RegisterForPushNotificationAsync()` on a `CallAgent` instance with the WNS registration channel obtained on application initialization.
 

articles/communication-services/how-tos/calling-sdk/push-notifications.md

@@ -16,13 +16,11 @@ zone_pivot_groups: acs-plat-web-ios-android-windows
 
 # Enable push notifications for calls
 
-In this article, you learn how to enable push notifications for Azure Communication Services calls. Setting up the push notifications lets your users know when they have an incoming call, which they can then answer.
+Push notifications send information from your application to users' devices. You can use push notifications to show a dialog, play a sound, or display incoming call into the app's UI layer.
 
-## Overview of push notifications
+In this article, you learn how to enable push notifications for Azure Communication Services calls. Communication Services provides integrations with [Azure Event Grid](../../../event-grid/overview.md) and [Azure Notification Hubs](../../../notification-hubs/notification-hubs-push-notification-overview.md) that enable you to add push notifications to your apps.
 
-Push notifications send information from your application to users' devices. You can use push notifications to show a dialog, play a sound, or display incoming call into the app UI layer. Azure Communication Services provides integrations with [Azure Event Grid](../../../event-grid/overview.md) and [Azure Notification Hubs](../../../notification-hubs/notification-hubs-push-notification-overview.md) that enable you to add push notifications to your apps.
-
-### TTL token
+## Overview of TTL tokens
 
 The time-to-live (TTL) token is a setting that determines the length of time that a notification token stays valid before becoming invalid. This setting is useful for applications where user engagement doesn't require daily interaction but remains critical over longer periods.
 

articles/communication-services/quickstarts/voice-video-calling/get-started-android-calling-chat-sdk.md

@@ -45,7 +45,9 @@ Specify the version of the Calling and Chat SDKs for Android in your application
     }
    ```
 
-The example uses the latest release version of the Chat SDK package `com.azure.android:azure-communication-chat`, but you can use any version. However, the version of the Trouter package `com.microsoft:trouter-client-android` that's included with the Chat SDK package `com.azure.android:azure-communication-chat` needs to be excluded. When the application is built, it will use the Trouter package version included by the Calling SDK package `com.azure.android:azure-communication-calling`.
+The example uses the latest release version of the Chat SDK package `com.azure.android:azure-communication-chat`, but you can use any version.
+
+The version of the Trouter package `com.microsoft:trouter-client-android` that's included with the Chat SDK package `com.azure.android:azure-communication-chat` needs to be excluded. When the application is built, it will use the Trouter package version included by the Calling SDK package `com.azure.android:azure-communication-calling`.
 
 ## Related content