two-communication-services-articles

Author: ShawnJackson

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

@@ -60,12 +60,10 @@ In case that you want to revoke an identity you need to follow [this process](..
 [!INCLUDE [Enable push notifications Windows](./includes/push-notifications/push-notifications-windows.md)]
 ::: zone-end
 
-## Next steps
+## Related content
+
 - [Learn how to subscribe to events](./events.md)
 - [Learn how to manage calls](./manage-calls.md)
 - [Learn how to manage video](./manage-video.md)
-
-## Related topics
-
 - [Migrate Android SDK push notifications to FCM v1](../../tutorials/call-chat-migrate-android-push-fcm-v1.md)
 - [Register for Android SDK push notifications using FCM v1](../../tutorials/call-chat-register-android-push-fcm-v1.md)

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

@@ -1,35 +1,42 @@
 ---
 ms.date: 08/08/2024
-ms.topic: quickstart
-titleSuffix: Azure Communication Services Calling and Chat SDK
+ms.topic: how-to
+titleSuffix: Azure Communication Services Calling SDK and Chat SDK
 author: sanathr
-title: Calling and Chat SDK in an Android application
+title: Add the Calling and Chat SDKs in an Android application
 ms.author: sanathr
 ms.service: azure-communication-services
-description: How to use both Calling and Chat SDK together in an Android application.
+description: Learn how to use the Calling SDK and the Chat SDK together in an Android application.
 ---
-# Add Calling and Chat SDK in an Android application
+# Add the Calling and Chat SDKs in an Android application
 
-This tutorial describes how Contoso can integrate both Calling and Chat SDK in an Android application.
+This article describes how you can integrate the Azure Communication Services Calling SDK and Chat SDK in an Android application.
 
-## Current limitation
+## Problem
 
-With Android Calling SDK versions earlier than `2.11.0`, building an Android application with both the Calling and Chat SDK's resulted in the following errors:
+With versions of the Calling SDK earlier than 2.11.0, building an Android application with both the Calling and Chat SDKs resulted in the following errors:
 
 ```
 Duplicate class com.skype.rt.XXX found in modules jetified-azure-communication-calling-1.2.0-runtime (com.azure.android:azure-communication-calling:1.2.0) and jetified-trouter-client-android-0.1.1-runtime (com.microsoft:trouter-client-android:0.1.1)
 
 2 files found with path 'lib/x86/libc++_shared.so' from inputs: - …\.gradle\...-azure-communication-calling-1.2.0\jni\x86\libc++_shared.so - …\.gradle\...-trouter-client-android-9.1.1\jni\x86\libc++_shared.so
 ```
 
-This issue was caused because of the conflicting `.jar` and `.so` files included in the Calling SDK package `com.azure.android:azure-communication-calling` and a transitive dependency package that the Chat SDK package `com.azure.android:azure-communication-chat` imports, `com.microsoft:trouter-client-android`.
+This problem had two causes:
+
+- Conflicting `.jar` and `.so` files included in the Calling SDK package `com.azure.android:azure-communication-calling`
+- A transitive dependency package that the Chat SDK package `com.azure.android:azure-communication-chat` imports, `com.microsoft:trouter-client-android`
 
 ## Solution
-From Android Calling SDK version 2.11.0 onwards, Contoso can integrate both the Calling and Chat SDKs within the same Android application. This was accomplished by making the Calling SDK rely on com.microsoft:trouter-client-android, similar to the Chat SDK’s dependency on the Trouter package, and eliminating the conflicting .jar and .so files previously included in the Calling SDK.
 
-## Implementation steps
+From Calling SDK version 2.11.0 onward, you can integrate both the Calling and Chat SDKs within the same Android application. The 2.11.0 version solved the problem by:
+
+- Eliminating the conflicting `.jar` and `.so` files.
+- Making the Calling SDK rely on `com.microsoft:trouter-client-android`, similar to the Chat SDK's dependency on the Trouter package.
 
-Specify the version of the Android Calling and Chat SDK in your application's Gradle build file as shown in the example:
+## Implementation
+
+Specify the version of the Calling and Chat SDKs for Android in your application's Gradle build file, as shown in this example:
 
    ```gradle
     implementation ('com.azure.android:azure-communication-calling:2.11.0')
@@ -38,7 +45,8 @@ Specify the version of the Android Calling and Chat SDK in your application's Gr
     }
    ```
 
-The version of `com.azure.android:azure-communication-chat` can be any version. The latest release version is used here as an example. However, the version of the Trouter package `com.microsoft:trouter-client-android` included with the Chat SDK `com.azure.android:azure-communication-chat` needs to be excluded. When the application is built, the Trouter package version included by the Calling SDK package `com.azure.android:azure-communication-calling` will be used.
+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`.
+
+## Related content
 
-## Next steps
-Quickstart sample is available in GitHub [Android QuickStarts](https://github.com/Azure-Samples/communication-services-android-quickstarts.git) under `Add-Chat-Calling` folder and follow the `README.md` on instructions how to run the sample.
+- A quickstart sample is available in the [GitHub repository for Android quickstarts](https://github.com/Azure-Samples/communication-services-android-quickstarts.git), in the `Add-Chat-Calling` folder. For instructions on how to run the sample, follow the `README.md` file.