chat and include files

Get started Chat UI and related includes

Author: vac0224

articles/communication-services/quickstarts/ui-library/get-started-chat-ui-library.md

@@ -1,5 +1,5 @@
 ---
-title: 'Quickstart: Integrate chat experiences in your app by using UI Library'
+title: Use UI components for chat
 titleSuffix: An Azure Communication Services quickstart
 description: Get started with Azure Communication Services UI Library composites to add chat communication experiences to your applications.
 author: dhiraj
@@ -11,11 +11,11 @@ zone_pivot_groups: acs-plat-web-ios-android
 ms.custom: mode-other
 ---
 
-# Quickstart: Add chat with UI Library
+# Use UI components for chat
 
-Get started with Azure Communication Services UI Library to quickly integrate communication experiences into your applications. In this quickstart, learn how to integrate UI Library chat composites into an application and set up the experience for your app users.
+Get started with Azure Communication Services UI Library to quickly integrate communication experiences into your applications. This article describes how to integrate UI Library chat composites into an application and set up the experience for your app users.
 
-Azure Communication Services UI Library renders a full chat experience right in your application. It takes care of connecting to Azure Communication Services chat services and updates a participant's presence automatically. As a developer, you need to decide about where in your app's user experience you want the chat experience to start and create only the Azure Communication Services resources as required.
+Azure Communication Services UI Library renders a full chat experience right in your application. It takes care of connecting to Azure Communication Services chat services and updates a participant's presence automatically. As a developer, you need to decide where in your app's user experience you want the chat experience to start and create only the Azure Communication Services resources as required.
 
 ::: zone pivot="platform-web"
 

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

@@ -8,7 +8,7 @@ ms.service: azure-communication-services
 
 [!INCLUDE [Public Preview Notice](../../../../includes/public-preview-include.md)]
 
-Get the sample Android application for this [quickstart](https://github.com/Azure-Samples/communication-services-android-quickstarts/tree/main/ui-chat) in the open-source Azure Communication Services [UI Library for Android](https://github.com/Azure/communication-ui-library-android).
+Get the sample Android application at [Azure Samples Android SDK for chat](https://github.com/Azure-Samples/communication-services-android-quickstarts/tree/main/ui-chat) in the open-source Azure Communication Services [UI Library for Android](https://github.com/Azure/communication-ui-library-android).
 
 ## Prerequisites
 
@@ -20,7 +20,7 @@ Get the sample Android application for this [quickstart](https://github.com/Azur
 
 ## Set up the project
 
-Complete the following sections to set up the quickstart project.
+Complete the following sections to set up the project.
 
 ### Create a new Android project
 

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

@@ -8,7 +8,7 @@ ms.service: azure-communication-services
 
 [!INCLUDE [Public Preview Notice](../../../../includes/public-preview-include.md)]
 
-Get the sample iOS application for this [quickstart](https://github.com/Azure-Samples/communication-services-ios-quickstarts/tree/main/ui-chat) in the open-source Azure Communication Services [UI Library for iOS](https://github.com/Azure/communication-ui-library-ios).
+Get the sample iOS application at [Azure Samples iOS SDK for chat](https://github.com/Azure-Samples/communication-services-ios-quickstarts/tree/main/ui-chat) in the open-source Azure Communication Services [UI Library for iOS](https://github.com/Azure/communication-ui-library-ios).
 
 ## Prerequisites
 
@@ -38,7 +38,7 @@ In Xcode, create a new project.
 
 ### Install the package and dependencies
 
-1. (Optional) For MacBook with M1, install and enable [Rosetta](https://support.apple.com/en-us/HT211861) in Xcode.
+1. (Optional) For MacBook with M1, install, and enable [Rosetta](https://support.apple.com/en-us/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.
 

articles/communication-services/quickstarts/ui-library/includes/get-started-chat/web.md

@@ -1,5 +1,5 @@
 ---
-description: In this tutorial, you learn how to use the chat composite on the web.
+description: This article describes how to use the chat composite on the web.
 author: garchiro7
 ms.author: jorgegarc
 ms.date: 5/1/2023
@@ -8,7 +8,7 @@ ms.service: azure-communication-services
 ---
 
 > [!NOTE]
-> For detailed documentation and quickstarts about the web UI Library, see the [web UI Library storybook](https://aka.ms/acsstorybook).
+> For more information about the web UI Library, see the [web UI Library storybook](https://aka.ms/acsstorybook).
 
 ## Prerequisites
 

articles/communication-services/tutorials/file-sharing-tutorial-acs-chat.md

@@ -1,7 +1,7 @@
 ---
-title: Enable file sharing using UI Library and Azure Blob Storage in an Azure communication Chat
-titleSuffix: An Azure Communication Services tutorial
-description: Learn how to use Azure Communication Services with the UI Library to enable file sharing through chat using Azure Blob Storage.
+title:  Add file sharing in chat using UI Library and Azure Blob Storage 
+titleSuffix: An Azure Communication Services article
+description: This article describes how to use Azure Communication Services with the UI Library to enable file sharing through chat using Azure Blob Storage.
 author: anjulgarg
 manager: alkwa
 services: azure-communication-services
@@ -13,58 +13,58 @@ ms.service: azure-communication-services
 ms.subservice: chat
 ---
 
-# Enable file sharing using UI Library in Azure Communication Services Chat with Azure Blob storage
+#  Add file sharing in chat using UI Library and Azure Blob storage
 
 [!INCLUDE [Public Preview Notice](../includes/public-preview-include.md)]
 
-In an Azure Communication Services Chat, we can enable file sharing between communication users. Note, Azure Communication Services Chat is different from the Teams Interoperability Chat ("Interop Chat"). If you want to enable file sharing in an Interop Chat, refer to [Add file sharing with UI Library in Teams Interoperability Chat](./file-sharing-tutorial-interop-chat.md).
+In an Azure Communication Services Chat, we can enable file sharing between communication users. Azure Communication Services Chat is different from the Teams Interoperability Chat, or *Interop Chat*. If you want to enable file sharing in an Interop Chat, see [Add file sharing with UI Library in Teams Interoperability Chat](./file-sharing-tutorial-interop-chat.md).
 
-In this tutorial, we're configuring the Azure Communication Services UI Library Chat Composite to enable file sharing. The UI Library Chat Composite provides a set of rich components and UI controls that can be used to enable file sharing. We're using Azure Blob Storage to enable the storage of the files that are shared through the chat thread.
+This article describes how to configure the Azure Communication Services UI Library Chat Composite to enable file sharing. The UI Library Chat Composite provides a set of rich components and UI controls we can use to enable file sharing. We're using Azure Blob Storage to enable the storage of the files that are shared through the chat thread.
 
 > [!IMPORTANT]
-> Azure Communication Services doesn't provide a file storage service. You need to use your own file storage service for sharing files. For the purpose of this tutorial, we're using Azure Blob Storage.\*\*
+> Azure Communication Services doesn't provide a file storage service. You need to use your own file storage service for sharing files. This tutorial describes how to use Azure Blob Storage.
 
 ## Download code
 
-Access the full code for this tutorial on [GitHub](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/ui-library-filesharing-chat-composite). If you want to use file sharing using UI Components, reference [this sample](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/ui-library-filesharing-ui-components).
+Access the full code for this tutorial at [UI Library Sample - File Sharing using UI Chat Composite](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/ui-library-filesharing-chat-composite). If you want to use file sharing using UI Components, see [UI Library Sample - File Sharing using UI Components](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/ui-library-filesharing-ui-components).
 
 ## Prerequisites
 
 - An Azure account with an active subscription. For details, see [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 - [Visual Studio Code](https://code.visualstudio.com/) on one of the [supported platforms](https://code.visualstudio.com/docs/supporting/requirements#_platforms).
-- [Node.js](https://nodejs.org/), Active LTS and Maintenance LTS versions (10.14.1 recommended). Use the `node --version` command to check your version.
+- [Node.js](https://nodejs.org/), Active LTS, and Maintenance LTS versions (10.14.1 recommended). Use the `node --version` command to check your version.
 - An active Communication Services resource and connection string. [Create a Communication Services resource](../quickstarts/create-communication-resource.md).
 
-This tutorial assumes that you already know how to set up and run a Chat Composite. You can follow the [Chat Composite tutorial](https://azure.github.io/communication-ui-library/?path=/docs/composites-chatcomposite--docs) to learn how to set up and run a Chat Composite.
+To use this article, you need to know how to set up and run a Chat Composite. For more information about how to set up and run a Chat Composite, see the [ChatComposite tutorial](https://azure.github.io/communication-ui-library/?path=/docs/composites-chatcomposite--docs).
 
 ## Overview
 
 The UI Library Chat Composite supports file sharing by enabling developers to pass the URL to a hosted file that is sent through the Azure Communication Services chat service. The UI Library renders the attached file and supports multiple extensions to configure the look and feel of the file sent. More specifically, it supports the following features:
 
-1. Attach file button for picking files through the OS File Picker
+1. Attach file button for picking files through the OS File Picker.
 2. Configure allowed file extensions.
 3. Enable/disable multiple uploads.
 4. File Icons for a wide variety of file types.
 5. File upload/download cards with progress indicators.
 6. Ability to dynamically validate each file upload and display errors on the UI.
-7. Ability to cancel an upload and remove an uploaded file before it's sent.
+7. Ability to cancel an upload and remove an uploaded file before sending.
 8. View uploaded files in MessageThread, download them. Allows asynchronous downloads.
 
-The diagram shows a typical flow of a file sharing scenario for both upload and download. The section marked as `Client Managed` shows the building blocks where developers need to have them implemented.
+The following diagram shows a typical flow of a file sharing scenario for both upload and download. The section marked as `Client Managed` shows the building blocks where developers need to implement them.
 
 ![Filesharing typical flow](./media/filesharing-typical-flow.png "Diagram that shows the file sharing typical flow.")
 
 ## Set up file storage using Azure Blob
 
 You can follow the tutorial [Upload file to Azure Blob Storage with an Azure Function](/azure/developer/javascript/how-to/with-web-app/azure-function-file-upload) to write the backend code required for file sharing.
 
-Once implemented, you can call this Azure Function inside the `handleAttachmentSelection` function to upload files to Azure Blob Storage. For the remaining of the tutorial, we assume you have generated the function using the tutorial for Azure Blob Storage linked previously.
+Once implemented, you can call this Azure Function inside the `handleAttachmentSelection` function to upload files to Azure Blob Storage. For the remaining of the tutorial, we assume you generated the function using the tutorial for Azure Blob Storage linked previously.
 
 ### Securing your Azure Blob storage container
 
-This tutorial assumes that your Azure blob storage container allows public access to the files you upload. Making your Azure storage containers public isn't recommended for real world production applications.
+This article assumes that your Azure blob storage container allows public access to the files you upload. Making your Azure storage containers public isn't recommended for real world production applications.
 
-For downloading the files, you upload to Azure blob storage, you can use shared access signatures (SAS). A shared access signature (SAS) provides secure delegated access to resources in your storage account. With a SAS, you have granular control over how a client can access your data.
+For downloading the files, you upload to Azure blob storage. Then you can use shared access signatures (SAS). A shared access signature (SAS) provides secure delegated access to resources in your storage account. With a SAS, you have granular control over how a client can access your data.
 
 The downloadable [GitHub sample](https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/ui-library-filesharing-chat-composite) showcases the use of SAS for creating SAS URLs to Azure Storage contents. Additionally, you can [read more about SAS](../../storage/common/storage-sas-overview.md).
 
@@ -300,7 +300,7 @@ export const attachmentUploadOptions: AttachmentUploadOptions = {
 
 ## File downloads - advanced usage
 
-By default, the UI library will open a new tab pointing to the URL you have set when you `notifyUploadCompleted`. Alternatively, you can have a custom logic to handle attachment downloads via `actionsForAttachment`. Let's take a look of an example.
+By default, the UI library opens a new tab pointing to the URL you set when you `notifyUploadCompleted`. Alternatively, you can use a custom logic to handle attachment downloads via `actionsForAttachment`. Let's take a look of an example.
 
 `App.tsx`
 
@@ -361,7 +361,7 @@ const customHandler = = async (attachment: AttachmentMetadata, message?: ChatMes
 }
 ```
 
-If there were any issues during the download and the user needs to be notified, we can just `throw` an error with a message in the `onClick` function then the message would be shown in the error bar on top of the Chat Composite.
+If there were any issues during the download and the user needs to be notified, you can `throw` an error with a message in the `onClick` function. Then the message displays in the error bar on top of the Chat Composite.
 
 ![File Download Error](./media/download-error.png "Screenshot that shows the File Download Error.")
 
@@ -374,7 +374,7 @@ If you want to clean up and remove a Communication Services subscription, you ca
 > [!div class="nextstepaction"]
 > [Check the rest of the UI Library](https://azure.github.io/communication-ui-library/)
 
-You may also want to:
+## Related articles
 
 - [Add chat to your app](../quickstarts/chat/get-started.md)
 - [Creating user access tokens](../quickstarts/identity/access-tokens.md)