include file

for chat

Author: vac0224

articles/communication-services/quickstarts/chat/includes/chat-android.md

@@ -434,4 +434,4 @@ In Android Studio, hit the Run button to build and run the project. In the conso
 
 ## Sample code
 
-Find the finalized code for this quickstart on GitHub at [Add chat to your app](https://github.com/Azure-Samples/communication-services-android-quickstarts/tree/main/Add-chat).
+Find the finalized code for this article in the GitHub sample [Add Chat to your application](https://github.com/Azure-Samples/communication-services-android-quickstarts/tree/main/Add-chat).

articles/communication-services/quickstarts/chat/includes/chat-az-cli.md

@@ -216,8 +216,7 @@ az communication chat message receipt send --thread "<chatThreadId>" --message-i
 - Replace `<chatThreadId>` with your chat thread ID.
 - Replace `<messageId>` to specify the ID of the latest message read by current user.
 - Replace `<endpoint>` with your Azure Communication Services endpoint.
-- Replace `<token>` with your access token obtained earlier with running `identity token issue` command. 
-
+- Replace `<token>` with your access token obtained earlier with running `identity token issue` command.
 
 ### Add a user as a participant to the chat thread
 
@@ -248,8 +247,7 @@ az communication chat participant list --thread "<chatThreadId>" --skip "<skip>"
 - Replace `<chatThreadId>` with your chat thread ID.
 - Use `<skip>` optionally to skip participants up to a specified position in the response.
 - Replace `<endpoint>` with your Azure Communication Services endpoint.
-- Replace `<token>` with your access token obtained earlier with running `identity token issue` command. 
-
+- Replace `<token>` with your access token obtained earlier with running `identity token issue` command.
 
 ### Remove a participant from a chat thread
 

articles/communication-services/quickstarts/chat/includes/chat-csharp.md

@@ -13,19 +13,19 @@ ms.author: rifox
 ---
 
 ## Prerequisites
-Before you get started, make sure to:
+
 - Create an Azure account with an active subscription. For details, see [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - Install [Visual Studio](https://visualstudio.microsoft.com/downloads/)
-- Create an Azure Communication Services resource. For details, see [Create an Azure Communication Services resource](../../create-communication-resource.md). You'll need to record your resource **endpoint and connection string** for this quickstart.
-- A [User Access Token](../../identity/access-tokens.md). Be sure to set the scope to **chat**, and **note the token string as well as the user_id string**. You can also use the Azure CLI and run the command below with your connection string to create a user and an access token.
+- Create an Azure Communication Services resource. For details, see [Create an Azure Communication Services resource](../../create-communication-resource.md). You need to record your resource **endpoint and connection string** for this article.
+- A [User Access Token](../../identity/access-tokens.md). Be sure to set the scope to **chat**, and **note the token string as well as the user_id string**. You can also use the Azure CLI and run the following command with your connection string to create a user and an access token.
 
   ```azurecli-interactive
   az communication identity token issue --scope chat --connection-string "yourConnectionString"
   ```
 
   For details, see [Use Azure CLI to Create and Manage Access Tokens](../../identity/access-tokens.md?pivots=platform-azcli).
 
-## Setting up
+## Set up
 
 ### Create a new C# application
 
@@ -56,18 +56,19 @@ The following classes handle some of the major features of the Azure Communicati
 
 | Name                                  | Description                                                  |
 | ------------------------------------- | ------------------------------------------------------------ |
-| ChatClient | This class is needed for the Chat functionality. You instantiate it with your subscription information, and use it to create, get and delete threads. |
+| ChatClient | This class is needed for the Chat functionality. You instantiate it with your subscription information, and use it to create, get, and delete threads. |
 | ChatThreadClient | This class is needed for the Chat Thread functionality. You obtain an instance via the ChatClient, and use it to send/receive/update/delete messages, add/remove/get participants, send typing notifications and read receipts. |
 
 ## Create a chat client
 
-To create a chat client, you'll use your Communication Services endpoint and the access token that was generated as part of the prerequisite steps. You need to use the `CommunicationIdentityClient` class from the Identity SDK to create a user and issue a token to pass to your chat client.
+To create a chat client, use your Communication Services endpoint and the access token that was generated as part of the prerequisite steps. You need to use the `CommunicationIdentityClient` class from the Identity SDK to create a user and issue a token to pass to your chat client.
 
 Learn more about [User Access Tokens](../../identity/access-tokens.md).
 
-This quickstart doesn't cover creating a service tier to manage tokens for your chat application, although it's recommended. Learn more about [Chat Architecture](../../../concepts/chat/concepts.md)
+This article doesn't cover creating a service tier to manage tokens for your chat application, although we recommend it. For more information, see [Chat Architecture](../../../concepts/chat/concepts.md).
+
+Copy the following code snippets and paste into the `Program.cs` source file.
 
-Copy the following code snippets and paste into source file: **Program.cs**
 ```csharp
 using Azure;
 using Azure.Communication;
@@ -93,10 +94,10 @@ namespace ChatQuickstart
 ## Start a chat thread
 
 Use the `createChatThread` method on the chatClient to create a chat thread
-- Use `topic` to give a topic to this chat; Topic can be updated after the chat thread is created using the `UpdateTopic` function.
-- Use `participants` property to pass a  list of `ChatParticipant` objects to be added to the chat thread. The `ChatParticipant` object is initialized with a `CommunicationIdentifier` object. `CommunicationIdentifier` could be of type `CommunicationUserIdentifier`, `MicrosoftTeamsUserIdentifier` or `PhoneNumberIdentifier`. For example, to get a `CommunicationIdentifier` object, you'll need to pass an Access ID which you created by following instruction to [Create a user](../../identity/access-tokens.md#create-an-identity)
+- Use `topic` to give a topic to this chat. You can update the topic after creating the chat thread using the `UpdateTopic` function.
+- Use `participants` property to pass a  list of `ChatParticipant` objects to be added to the chat thread. The `ChatParticipant` object is initialized with a `CommunicationIdentifier` object. `CommunicationIdentifier` could be of type `CommunicationUserIdentifier`, `MicrosoftTeamsUserIdentifier`, or `PhoneNumberIdentifier`. For example, to get a `CommunicationIdentifier` object, you need to pass an Access ID which you created by following instruction to [Create a user](../../identity/access-tokens.md#create-an-identity)
 
-The response object from the `createChatThread` method contains the `chatThread` details. To interact with the chat thread operations such as adding participants, sending a message, deleting a message, etc., a `chatThreadClient` client instance needs to instantiated using the `GetChatThreadClient` method on the `ChatClient` client.
+The response object from the `createChatThread` method contains the `chatThread` details. To interact with the chat thread operations such as adding participants, sending a message, deleting a message, and so on, a `chatThreadClient` client instance needs to instantiated using the `GetChatThreadClient` method on the `ChatClient` client.
 
 ```csharp
 var chatParticipant = new ChatParticipant(identifier: new CommunicationUserIdentifier(id: "<Access_ID>"))
@@ -109,7 +110,7 @@ string threadId = chatThreadClient.Id;
 ```
 
 ## Get a chat thread client
-The `GetChatThreadClient` method returns a thread client for a thread that already exists. It can be used for performing operations on the created thread: add members, send message, etc. threadId is the unique ID of the existing chat thread.
+The `GetChatThreadClient` method returns a thread client for a thread that already exists. You can use it to perform operations on the created thread: add members, send message, and so on. `threadId` is the unique ID of the existing chat thread.
 
 ```csharp
 string threadId = "<THREAD_ID>";
@@ -131,10 +132,10 @@ await foreach (ChatThreadItem chatThreadItem in chatThreadItems)
 
 Use `SendMessage` to send a message to a thread.
 
-- Use `content` to provide the content for the message, it's required.
-- Use `type` for the content type of the message such as 'Text' or 'Html'. If not specified, 'Text' will be set.
-- Use `senderDisplayName` to specify the display name of the sender. If not specified, empty string will be set.
-- Use `metadata` optionally to include any additional data you want to send along with the message. This field provides a mechanism for developers to extend chat message functionality and add custom information for your use case. For example, when sharing a file link in the message, you might want to add 'hasAttachment:true' in metadata so that recipient's application can parse that and display accordingly.
+- Use `content` to provide the content for the message. Required.
+- Use `type` for the content type of the message such as 'Text' or 'Html'. If not specified, 'Text' is set.
+- Use `senderDisplayName` to specify the display name of the sender. If not specified, empty string is set.
+- Optional: Use `metadata` to include other data you want to send along with the message. This field provides a mechanism for developers to extend chat message functionality and add custom information for your use case. For example, when sharing a file link in the message, you might want to add 'hasAttachment:true' in metadata so that recipient's application can parse that and display accordingly.
 
 ```csharp
 SendChatMessageOptions sendChatMessageOptions = new SendChatMessageOptions()
@@ -162,29 +163,29 @@ await foreach (ChatMessage message in allMessages)
 }
 ```
 
-`GetMessages` takes an optional `DateTimeOffset` parameter. If that offset is specified, you'll receive messages that were received, updated or deleted after it. Note that messages received before the offset time but edited or removed after it will also be returned.
+`GetMessages` takes an optional `DateTimeOffset` parameter. If that offset is specified, you receive messages that were received, updated, or deleted after it. Messages received before the offset time but edited or removed afterward are also returned.
 
 `GetMessages` returns the latest version of the message, including any edits or deletes that happened to the message using `UpdateMessage` and `DeleteMessage`. For deleted messages, `chatMessage.DeletedOn` returns a datetime value indicating when that message was deleted. For edited messages, `chatMessage.EditedOn` returns a datetime indicating when the message was edited. The original time of message creation can be accessed using `chatMessage.CreatedOn`, and it can be used for ordering the messages.
 
-`GetMessages` returns different types of messages which can be identified by `chatMessage.Type`. These types are:
+`GetMessages` returns different types of messages. You can identify the type from the `chatMessage.Type`. The types are:
 
 - `Text`: Regular chat message sent by a thread member.
 
-- `Html`:  A formatted text message. Note that Communication Services users currently can't send RichText messages. This message type is supported by messages sent from Teams users to Communication Services users in Teams Interop scenarios.
+- `Html`: A formatted text message. Communication Services users currently can't send RichText messages. This message type is supported for messages sent from Teams users to Communication Services users in Teams Interop scenarios.
 
-- `TopicUpdated`: System message that indicates the topic has been updated. (readonly)
+- `TopicUpdated`: System message that indicates the topic is updated. (readonly)
 
-- `ParticipantAdded`: System message that indicates one or more participants have been added to the chat thread.(readonly)
+- `ParticipantAdded`: System message that indicates one or more participants are added to the chat thread (readonly).
 
-- `ParticipantRemoved`: System message that indicates a participant has been removed from the chat thread.
+- `ParticipantRemoved`: System message that indicates a participant is removed from the chat thread.
 
-For more details, see [Message Types](../../../concepts/chat/concepts.md#message-types).
+For more information, see [Message Types](../../../concepts/chat/concepts.md#message-types).
 
 ## Add a user as a participant to the chat thread
 
-Once a thread is created, you can then add and remove users from it. By adding users, you give them access to be able to send messages to the thread, and add/remove other participant. Before calling `AddParticipants`, ensure that you have acquired a new access token and identity for that user. The user will need that access token in order to initialize their chat client.
+Once a thread is created, you can then add and remove users from it. By adding users, you give them access to be able to send messages to the thread, and add/remove other participant. Before calling `AddParticipants`, ensure that you acquire a new access token and identity for that user. The user needs that access token in order to initialize their chat client.
 
-Use `AddParticipants` to add one or more participants to the chat thread. The following are the supported attributes for each thread participant(s):
+Use `AddParticipants` to add one or more participants to the chat thread. The following are the supported attributes for each thread participant:
 - `communicationUser`, required, is the identity of the thread participant.
 - `displayName`, optional, is the display name for the thread participant.
 - `shareHistoryTime`, optional, time from which the chat history is shared with the participant.
@@ -218,7 +219,7 @@ await foreach (ChatParticipant participant in allParticipants)
 
 ## Send read receipt
 
-Use `SendReadReceipt` to notify other participants that the message is read by the user.
+Use `SendReadReceipt` to notify other participants that the user read the message.
 
 ```csharp
 await chatThreadClient.SendReadReceiptAsync(messageId: messageId);
@@ -233,4 +234,5 @@ dotnet run
 ```
 
 ## Sample Code
-Find the finalized code for this quickstart on [GitHub](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/add-chat).
+
+Find the finalized code for this article in the GitHub sample [Add Chat to your application](https://github.com/Azure-Samples/communication-services-dotnet-quickstarts/tree/main/add-chat).