docs: add pr review suggestions #12450

Author: IvanDanchev

components/chat/file-uploads-and-media.md

@@ -25,9 +25,9 @@ Enable file uploads by setting the `EnableFileUpload` parameter to `true`:
 
 The `MessageFilesLayoutMode` parameter controls how file attachments are displayed within chat messages. Choose from three layout options to best fit your application's design:
 
-* `ChatMessageFilesLayoutMode.Vertical` - Files are displayed in a vertical stack (default)
-* `ChatMessageFilesLayoutMode.Horizontal` - Files are displayed in a horizontal row
-* `ChatMessageFilesLayoutMode.Wrap` - Files wrap to the next line when they exceed the message width
+* `ChatMessageFilesLayoutMode.Vertical`—Files are displayed in a vertical stack (default)
+* `ChatMessageFilesLayoutMode.Horizontal`—Files are displayed in a horizontal row
+* `ChatMessageFilesLayoutMode.Wrap`—Files wrap to the next line when they exceed the message width
 
 ````RAZOR.skip-repl
 <TelerikChat Data="@ChatData"

components/chat/messages.md

@@ -14,7 +14,9 @@ The Telerik UI for Blazor Chat component provides comprehensive control over mes
 
 ## Typing Indicator
 
-The Chat component supports displaying a typing indicator to show when another user is composing a message. Set the `IsTypingField` parameter to specify which field in your data model indicates typing status, and set that field to `true` on a message to display the typing indicator instead of message content.
+The Chat supports displaying a typing indicator to show when another user is composing a message. When a message has `IsTyping` set to `true`, the component will display an animated typing indicator (typically three dots) instead of the message content. This provides visual feedback that enhances the conversational experience, especially in real-time chat scenarios.
+
+First, set the `IsTypingField` parameter to specify which field in your data model indicates typing status. Next, set that field to `true` on a message to display the typing indicator.
 
 ````Razor
 <TelerikButton OnClick="@AddTypingMessage">Show Typing Indicator</TelerikButton>
@@ -74,8 +76,6 @@ The Chat component supports displaying a typing indicator to show when another u
 }
 ````
 
-When a message has `IsTyping` set to `true`, the Chat will display an animated typing indicator (typically three dots) instead of the message content. This provides visual feedback that enhances the conversational experience, especially in real-time chat scenarios.
-
 ## Context Menu Message Actions
 
 Configure context menu actions that appear when users right-click on messages. These actions provide quick access to common message operations.
@@ -245,7 +245,7 @@ Control the width behavior of chat messages using the `MessageWidthMode` paramet
 
 ## Author and Receiver Message Settings
 
-The Chat component allows you to configure settings specifically for author messages (sent by the current user) and receiver messages (received from other users) using `ChatAuthorMessageSettings` and `ChatReceiverMessageSettings` components. These settings take precedence over global Chat settings, enabling different configurations for sent and received messages.
+The Chat component lets you configure settings specifically for author messages (sent by the current user) and receiver messages (received from other users) using `ChatAuthorMessageSettings` and `ChatReceiverMessageSettings` components. These settings take precedence over global Chat settings, enabling different configurations for sent and received messages.
 
 Use these settings to customize message behavior, appearance, and available actions based on whether the message was sent or received. For example, you might want different context menu actions, toolbar actions, or file actions for your own messages versus messages from others.
 
@@ -345,13 +345,13 @@ Use these settings to customize message behavior, appearance, and available acti
 }
 ````
 
-Available settings for both `ChatAuthorMessageSettings` and `ChatReceiverMessageSettings`:
+`ChatAuthorMessageSettings` and `ChatReceiverMessageSettings` provide the following settings:
 
-* `EnableMessageCollapse` - Enables the collapse functionality for long messages
-* `MessageWidthMode` - Controls message width (`Standard` or `Full`)
-* `ChatMessageContextMenuActions` - Define context menu actions for right-click interactions
-* `ChatMessageToolbarActions` - Define toolbar actions that appear on hover or selection
-* `ChatFileActions` - Define actions available for file attachments
+* `EnableMessageCollapse`&mdash;Enables the collapse functionality for long messages
+* `MessageWidthMode`&mdash;Controls message width (`Standard` or `Full`)
+* `ChatMessageContextMenuActions`&mdash;Defines context menu actions for right-click interactions
+* `ChatMessageToolbarActions`&mdash;Defines toolbar actions that appear on hover or selection
+* `ChatFileActions`&mdash;Defines actions available for file attachments
 
 If no author or receiver-specific setting is provided, the component falls back to the global Chat settings.
 

components/chat/quick-actions.md

@@ -20,9 +20,11 @@ Message suggestions provide users with quick reply options that appear below the
 
 The `SuggestionsLayoutMode` parameter controls how suggestions are displayed in the chat interface. Choose from three layout options to optimize the presentation based on the number and length of your suggestions:
 
-* `ChatSuggestionsLayoutMode.Wrap` - Suggestions wrap to the next line if they exceed the container width (default)
-* `ChatSuggestionsLayoutMode.Scroll` - Suggestions are displayed in a single line with horizontal scrolling
-* `ChatSuggestionsLayoutMode.ScrollButtons` - Suggestions are displayed in a single line with horizontal scrolling and navigation buttons
+* `ChatSuggestionsLayoutMode.Wrap`—Suggestions wrap to the next line if they exceed the container width (default)
+* `ChatSuggestionsLayoutMode.Scroll`—Suggestions are displayed in a single line with horizontal scrolling
+* `ChatSuggestionsLayoutMode.ScrollButtons`—Suggestions are displayed in a single line with horizontal scrolling and navigation 
+
+Use `Scroll` or `ScrollButtons` mode when you have many suggestions or longer text that won't fit comfortably in the available width. The `ScrollButtons` mode is particularly helpful for users who prefer button navigation over scrolling gestures.
 
 ````Razor
 <TelerikChat Data="@ChatData"
@@ -58,15 +60,13 @@ The `SuggestionsLayoutMode` parameter controls how suggestions are displayed in
 }
 ````
 
-Use `Scroll` or `ScrollButtons` mode when you have many suggestions or longer text that won't fit comfortably in the available width. The `ScrollButtons` mode is particularly helpful for users who prefer button navigation over scrolling gestures.
-
 ## Suggested Actions Layout Mode
 
 The `SuggestedActionsLayoutMode` parameter controls how suggested actions (quick actions attached to specific messages) are displayed. Similar to `SuggestionsLayoutMode`, it offers three layout options:
 
-* `ChatSuggestedActionsLayoutMode.Wrap` - Suggested actions wrap to the next line (default)
-* `ChatSuggestedActionsLayoutMode.Scroll` - Suggested actions are displayed in a single line with horizontal scrolling
-* `ChatSuggestedActionsLayoutMode.ScrollButtons` - Suggested actions are displayed in a single line with horizontal scrolling and navigation buttons
+* `ChatSuggestedActionsLayoutMode.Wrap`&mdash;Suggested actions wrap to the next line (default)
+* `ChatSuggestedActionsLayoutMode.Scroll`&mdash;Suggested actions are displayed in a single line with horizontal scrolling
+* `ChatSuggestedActionsLayoutMode.ScrollButtons`&mdash;Suggested actions are displayed in a single line with horizontal scrolling and navigation buttons
 
 ````Razor
 <TelerikChat Data="@ChatData"

components/chat/templates.md

@@ -29,7 +29,7 @@ This template allows you to customize the Chat header, where you can display tit
 
 ## NoDataTemplate
 
-The `NoDataTemplate` allows you to define custom content displayed when the Chat has no messages. This is useful for showing welcome messages, instructions, or branding when the conversation is empty.
+The `NoDataTemplate` lets you to define custom content displayed when the Chat has no messages. This is useful for showing welcome messages, instructions, or branding when the conversation is empty.
 
 ````RAZOR.skip-repl
 <NoDataTemplate>
@@ -40,7 +40,7 @@ The `NoDataTemplate` allows you to define custom content displayed when the Chat
 
 ## MessageContentTemplate
 
-Customize how individual message content is rendered within the Chat. This template has been renamed from `MessageTemplate` for better clarity.
+The `MessageContentTemplate` provides the option to customize how individual message content is rendered within the Chat.
 
 ````RAZOR.skip-repl
 <MessageContentTemplate>