edit pass: get-started-calling-with-chat

Author: ShawnJackson

articles/communication-services/quickstarts/ui-library/includes/get-started-calling-with-chat/android.md

@@ -17,7 +17,7 @@ ms.service: azure-communication-services
 
 You can get a [complete sample project](https://github.com/Azure-Samples/communication-services-calling-ui-with-chat-android) from GitHub.
 
-## Create an Android project
+## Set up the project
 
 In Android Studio, create a new project:
 
@@ -78,12 +78,11 @@ You need two Maven repositories to integrate the library:
     }
     ```
 
-## Connect to the Teams Meeting with calling and chat
+## Connect to the Teams meeting with calling and chat
 
-- First we will use CallComposite to connect to the call
-- Once user is admitted to the call, CallComposite will notify us by changing status to `connected`
-- Then user can be connected to the chat thread
-- When the user clicks **Chat** button, a custom button is added to `CallComposite`. `CallComposite` is minimized, and Chat is displayed.
+You use `CallComposite` to connect to the call. After a user is admitted to the call, `CallComposite` notifies you by changing the status to `connected`. Then the user can be connected to the chat thread.
+
+When the user selects the **Chat** button, a custom button is added to `CallComposite`. `CallComposite` is minimized, and **Chat** appears in Teams.
 
 ## Add a button and chat container view to Activity_main.xml
 
@@ -128,7 +127,7 @@ In the *app/src/main/res/layout/activity_main.xml* layout file, add the followin
 </androidx.constraintlayout.widget.ConstraintLayout>
 ```
 
-## Get a Chat icon
+## Download a Chat icon
 
 1. Download an icon from the [GitHub repository](https://github.com/microsoft/fluentui-system-icons/blob/master/android/library/src/main/res/drawable/ic_fluent_chat_24_regular.xml).
 1. Save the icon to *UILibraryQuickStart/app/src/main/res/drawable*.
@@ -139,14 +138,14 @@ In the *app/src/main/res/layout/activity_main.xml* layout file, add the followin
 To initialize the call composite, go to `MainActivity` and update connection settings:
 
 - Replace `TEAM_MEETING_LINK` with the Teams meeting link.
-- Replace `ACS_ENDPOINT` with your Communication Services resource's endpoint.
+- Replace `ACS_ENDPOINT` with your Azure Communication Services resource's endpoint.
 - Replace `DISPLAY_NAME` with your name.
-- Replace `USER_ID` with your Communication Services user ID.
+- Replace `USER_ID` with your Azure Communication Services user ID.
 - Replace `USER_ACCESS_TOKEN` with your token.
 
-### Get a Teams meeting chat thread for a Communication Services user
+### Get a Teams meeting chat thread for an Azure Communication Services user
 
-You can retrieve Teams meeting details by using Graph APIs, as described in the [Graph documentation](/graph/api/onlinemeeting-createorget). The Communication Services Calling SDK accepts a full Teams meeting link or a meeting ID. They're returned as part of the `onlineMeeting` resource, which is accessible under the [joinWebUrl](/graph/api/resources/onlineMeeting) property.
+You can retrieve Teams meeting details by using Graph APIs, as described in the [Graph documentation](/graph/api/onlinemeeting-createorget). The Azure Communication Services Calling SDK accepts a full Teams meeting link or a meeting ID. They're returned as part of the `onlineMeeting` resource, which is accessible under the [joinWebUrl](/graph/api/resources/onlineMeeting) property.
 
 With the Graph APIs, you can also obtain the `threadID` value. The response has a `chatInfo` object that contains the `threadID` value.
 
@@ -228,7 +227,7 @@ class MainActivity : AppCompatActivity() {
             .build()
 
         callComposite.addOnCallStateChangedEventHandler { callState ->
-            // When a user is admitted to the the Teams meeting, the call state becomes connected.
+            // When a user is admitted to the Teams meeting, the call state becomes connected.
             // Only users admitted to the meeting can connect to the meeting's chat thread.
             if (callState.code == CallCompositeCallStateCode.CONNECTED) {
                 connectChat()
@@ -361,7 +360,7 @@ public class MainActivity extends AppCompatActivity {
                 .build();
 
         callComposite.addOnCallStateChangedEventHandler(callState -> {
-                    // When a user is admitted to the the Teams meeting, the call state becomes connected.
+                    // When a user is admitted to the Teams meeting, the call state becomes connected.
                     // Only users admitted to the meeting can connect to the meeting's chat thread.
                     if (callState.getCode() == CallCompositeCallStateCode.CONNECTED) {
                         connectChat();

articles/communication-services/quickstarts/ui-library/includes/get-started-calling-with-chat/ios.md

@@ -9,15 +9,19 @@ ms.service: azure-communication-services
 ## Prerequisites
 
 - An Azure account and an active Azure subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- A Mac running [Xcode](https://go.microsoft.com/fwLink/p/?LinkID=266532) 13 or later and a valid developer certificate installed in your keychain. [CocoaPods](https://cocoapods.org/) must also be installed to fetch dependencies.
+- A Mac running [Xcode](https://go.microsoft.com/fwLink/p/?LinkID=266532) 13 or later, and a valid developer certificate installed in your keychain. [CocoaPods](https://cocoapods.org/) must also be installed to fetch dependencies.
 - A deployed [Azure Communication Services resource](../../../create-communication-resource.md).
 - An Azure Communication Services [access token](../../../identity/quick-create-identity.md).
 
 ## Get a complete sample
 
 You can get a [complete sample project](https://github.com/Azure-Samples/communication-services-calling-ui-with-chat-ios) from GitHub.
 
-## Create a new Xcode project
+## Set up the project
+
+Complete the following sections to set up the quickstart project.
+
+### Create a new Xcode project
 
 In Xcode, create a new project:
 
@@ -31,9 +35,9 @@ In Xcode, create a new project:
 
    :::image type="content" source="../../media/xcode-new-project-details.png" alt-text="Screenshot that shows setting new project options in Xcode.":::
 
-## Install the package and dependencies
+### Install the package and dependencies
 
-1. (Optional) For MacBook with M1, install, and enable [Rosetta](https://support.apple.com/HT211861) in Xcode.
+1. (Optional) For MacBook with M1, install and enable [Rosetta](https://support.apple.com/HT211861) in Xcode.
 
 1. In your project root directory, run `pod init` to create a Podfile. If you encounter an error, update [CocoaPods](https://guides.cocoapods.org/using/getting-started.html) to the current version.
 
@@ -51,13 +55,13 @@ In Xcode, create a new project:
 
 1. Run `pod install --repo-update`.
 
-1. In Xcode, open the generated.xcworkspace* file.
+1. In Xcode, open the *generated.xcworkspace* file.
 
-## Request access to device hardware
+### Request access to device hardware
 
-To access the device's hardware, including the microphone, and camera, update your app's information property list. Set the associated value to a string that's included in the dialog the system uses to request access from the user.
+To access the device's hardware, including the microphone and camera, update your app's information property list. Set the associated value to a string that's included in the dialog that the system uses to request access from the user.
 
-1. Right-click the `Info.plist` entry of the project tree and select **Open As** > **Source Code**. Add the following lines to the top level `<dict>` section, and then save the file.
+1. Right-click the `Info.plist` entry of the project tree and select **Open As** > **Source Code**. Add the following lines to the top-level `<dict>` section, and then save the file.
 
    ```xml
    <key>NSCameraUsageDescription</key>
@@ -68,39 +72,39 @@ To access the device's hardware, including the microphone, and camera, update yo
 
    Here's an example of the `Info.plist` source code in an Xcode file:
 
-   :::image type="content" source="../../media/xcode-info-plist-source-code.png" alt-text="Screenshot that shows an example of the info plist source code in an Xcode file.":::
+   :::image type="content" source="../../media/xcode-info-plist-source-code.png" alt-text="Screenshot that shows example source code for the information property list in an Xcode file.":::
 
 1. To verify that device permission requests are added correctly, select **Open As** > **Property List**. Check that the information property list looks similar to the following example:
 
    :::image type="content" source="../../media/xcode-info-plist.png" alt-text="Screenshot that shows the camera and microphone device privacy in Xcode.":::
 
-## Turn off Bitcode
+### Turn off Bitcode
 
 In the Xcode project, under **Build Settings**, set the **Enable Bitcode** option to **No**. To find the setting, change the filter from **Basic** to **All** or use the search bar.
 
 :::image type="content" source="../../media/xcode-bitcode-option.png" alt-text="Screenshot that shows the Build Settings option to turn off Bitcode.":::
 
-## Download a Chat icon
+### Download a Chat icon
 
-- Download an icon from [here](https://github.com/microsoft/fluentui-system-icons/blob/master/assets/Chat/SVG/ic_fluent_chat_24_regular.svg).
-- Open downloaded file and change `fill` to the `fill="#FFFFFF"`.
-- In the Xcode go to Assets. Create a new image set and name it ic_fluent_chat_24_regular. Select downloaded file as universal icon.
+1. Download an icon from the [GitHub repository](https://github.com/microsoft/fluentui-system-icons/blob/master/assets/Chat/SVG/ic_fluent_chat_24_regular.svg).
+1. Open the downloaded file and change `fill` to `fill="#FFFFFF"`.
+1. In Xcode, go to **Assets**. Create a new image set and name it **ic_fluent_chat_24_regular**. Select the downloaded file as the universal icon.
 
 ## Initialize the composite
 
 To initialize the composite, go to `ViewController` and update connection settings:
 
 - Replace `TEAM_MEETING_LINK` with the Teams meeting link.
-- Replace `ACS_ENDPOINT` with your ACS resource's endpoint.
+- Replace `ACS_ENDPOINT` with your Azure Communication Services resource's endpoint.
 - Replace `DISPLAY_NAME` with your name.
-- Replace `USER_ID` with ACS user ID.
+- Replace `USER_ID` with your Azure Communication Services user ID.
 - Replace `USER_ACCESS_TOKEN` with your token.
 
-### Get a Teams meeting chat thread for a Communication Services user
+### Get a Teams meeting chat thread for an Azure Communication Services user
 
-The Teams meeting details can be retrieved using Graph APIs, detailed in [Graph documentation](/graph/api/onlinemeeting-createorget). The Communication Services Calling SDK accepts a full Teams meeting link or a meeting ID. They're returned as part of the `onlineMeeting` resource, accessible under the [joinWebUrl](/graph/api/resources/onlinemeeting) property
+You can retrieve Teams meeting details by using Graph APIs, as described in the [Graph documentation](/graph/api/onlinemeeting-createorget). The Azure Communication Services Calling SDK accepts a full Teams meeting link or a meeting ID. They're returned as part of the `onlineMeeting` resource, which is accessible under the [joinWebUrl](/graph/api/resources/onlineMeeting) property.
 
-With the Graph APIs, you can also obtain the threadID. The response has a chatInfo object that contains the threadID.
+With the Graph APIs, you can also obtain the `threadID` value. The response has a `chatInfo` object that contains the `threadID` value.
 
 ```swift
 import UIKit