address comments

Author: didiyordanova

_contentTemplates/get-started.md

@@ -37,6 +37,7 @@ To visualize the Telerik controls, register them in the `MauiProgram.cs` file of
 	.UseTelerik()
 	<!-- Code omitted for brevity -->
 	```
+
 #end
 
 #add-telerik-component

controls/bottomsheet/getting-started.md

@@ -18,11 +18,11 @@ At the end, you will achieve the following result.
 
 Before adding the BottomSheet, you need to:
 
-1. [Set up your .NET MAUI application]({%slug maui-getting-started %}#step-1-set-up-your-net-maui-application).
+1. [Set up your .NET MAUI application]({%slug maui-getting-started%}#prerequisites).
 
-1. [Download Telerik UI for .NET MAUI]({% slug maui-getting-started %}#step-2-download-telerik-ui-for-net-maui).
+1. [Download Telerik UI for .NET MAUI]({% slug maui-getting-started%}#step-0-start-your-free-trial).
 
-1. [Install Telerik UI for .NET MAUI]({%slug maui-getting-started %}#step-3-install-telerik-ui-for-net-maui).
+1. [Install Telerik UI for .NET MAUI]({%slug maui-getting-started%}#step-3-add-the-telerik-nuGet-server).
 
 ## Define the Control
 

controls/speechtotextbutton/getting-started.md

@@ -18,15 +18,15 @@ At the end, you will achieve the following result.
 
 Before adding the SpeechToTextButton, you need to:
 
-1. [Set up your .NET MAUI application]({%slug maui-getting-started %}#step-1-set-up-your-net-maui-application).
+1. [Set up your .NET MAUI application]({%slug maui-getting-started%}#prerequisites).
 
-1. [Download Telerik UI for .NET MAUI]({% slug maui-getting-started %}#step-2-download-telerik-ui-for-net-maui).
+1. [Download Telerik UI for .NET MAUI]({% slug maui-getting-started%}#step-0-start-your-free-trial).
 
-1. [Install Telerik UI for .NET MAUI]({%slug maui-getting-started %}#step-3-install-telerik-ui-for-net-maui).
+1. [Install Telerik UI for .NET MAUI]({%slug maui-getting-started%}#step-3-add-the-telerik-nuGet-server).
 
 ## Required Permissions
 
-Before adding the contol, ensure that you have the required permissions set up in your project:
+Before adding the contol, ensure that you have the required permissions set up in your project.
 
 ### Android
 
@@ -49,7 +49,7 @@ Add the `NSMicrophoneUsageDescription` and `NSSpeechRecognitionUsageDescription`
 
 ### WinUI
 
-There are limitations when using the SpeechToTextButton on WinUI. When clicking on the control, the InvalidOperationException occurs.
+There are limitations when using the SpeechToTextButton on WinUI. When clicking on the control, the `InvalidOperationException` occurs.
 
 To turn speech recognition on WinUI, review the [WinUI Support]({%slug speechtotextbutton-winui-support%}) article.
 

controls/speechtotextbutton/overview.md

@@ -1,7 +1,7 @@
 ---
 title: Overview
 page_title: .NET MAUI SpeechToTextButton Documentation - Overview
-description: Try now the Telerik UI for .NET MAUI SpeechToTextButton control 
+description: Learn how the Telerik UI for .NET MAUI SpeechToTextButton enables seamless speech-to-text conversion in your applications.
 tags: speech to text for .net maui, .net maui, ui for .net maui, microsoft .net maui
 position: 0
 slug: speechtotextbutton-overview

controls/speechtotextbutton/states.md

@@ -9,9 +9,7 @@ slug: speechtotextbutton-states
 
 # .NET MAUI SpeechToTextButton Architecture and States
 
-The SpeechTextButton control provides visual feedback and handle user interactions. The button uses a speech recognition service. The service provides per platform implementation or an AI agent conenction. Almost all operations are asynconous.
-
-The SpeechToTextButton control in .NET MAUI has several states that reflect its current operation and user interaction. 
+The SpeechTextButton control handles user interactions and provides visual feedback about its current state, for example, when it's listening or ready. The button uses a speech recognition service that varies by platform and also provides an AI agent connection. Almost all operations are asynchronous.
 
 The image below explains how the control works and how the states are managed: 
 

controls/speechtotextbutton/visual-states.md

@@ -9,7 +9,7 @@ slug: speechtotextbutton-visual-states
 
 # .NET MAUI SpeechToTextButton Visual States
 
-The SpeechToTextButton control provides visual states that allow you to customize its appearance based on different interaction and operational states. Visual states enable you to create responsive UI that provides clear feedback to users about the control's current status.
+The SpeechToTextButton control provides visual states that allow you to customize its appearance based on user interactions and operational states. Visual states enable you to create responsive UI that provides clear feedback to users about the control's current status.
 
 You can use visual states to change the visual appearance of the control depending on its current state—whether it's disabled, pressed, listening for speech, or encountering an error.
 
@@ -32,11 +32,11 @@ The SpeechToTextButton provides the following `CommonStates` visual states:
 
 The SpeechToTextButton automatically transitions between visual states based on user interaction and speech recognition status:
 
-- `Normal` → `Pressed`—When user starts pressing the button
-- `Pressed` → `Listening`—When speech recognition begins
-- `Listening` → `Normal`—When speech recognition completes successfully
-- Any State → `Error`—When an error occurs during operation
-- Any State → `Disabled`—When the control is programmatically disabled
+- `Normal` → `Pressed`—When the user presses the button.
+- `Pressed` → `Listening`—When speech recognition begins.
+- `Listening` → `Normal`—When speech recognition completes successfully.
+- Any State → `Error`—When an error occurs during operation.
+- Any State → `Disabled`—When the control is programmatically disabled.
 
 ## Using Visual States
 

controls/speechtotextbutton/winui-support.md

@@ -14,26 +14,25 @@ The Speech Recognizer uses platform-specific speech recognition services. By def
 
 On WinUI, the `RadSpeechRecognizer` is not set to the `RadSpeechToTextButton`. When you click the control, an `InvalidOperationException` is thrown. The reason behind this is a limitation in the WinUI platform speech recognition service—[`Windows.Media.SpeechRecognition`](https://learn.microsoft.com/en-us/uwp/api/windows.media.speechrecognition?view=winrt-26100).
 
-The `RadSpeechRecognizer` on WinUI utilizes the [`Windows.Media.SpeechRecognition`](https://learn.microsoft.com/en-us/uwp/api/windows.media.speechrecognition?view=winrt-26100). There are specific considerations when using the control on WinUI due to limitations in the `Windows.Media.SpeechRecognition` API.
+The `RadSpeechRecognizer` on WinUI utilizes the [`Windows.Media.SpeechRecognition`](https://learn.microsoft.com/en-us/uwp/api/windows.media.speechrecognition?view=winrt-26100). There are specific considerations when using the control on WinUI due to limitations in the `Windows.Media.SpeechRecognition` API. The app crashes when trying to close the application via the "X" button and the app is **Packaged**.
 
-## Limitations in Windows.Media.SpeechRecognition
-
-* The app crashes when trying to close the application via the "X" button and the app is **Packaged**. There is an open bug report: [Application crashes after using SpeechRecognizer in a Packaged App](https://github.com/microsoft/microsoft-ui-xaml/issues/10697)
+> See the following bug report for more details: [Application crashes after using SpeechRecognizer in a Packaged App](https://github.com/microsoft/microsoft-ui-xaml/issues/10697).
 
 ## Solutions
 
-To use the SpeechToTextButton on WinUI, you can use one of the following approaches:
+To use the SpeechToTextButton on WinUI, you can use one of the following approaches described in the table below:
+
+| Packaged Apps | Unpackaged Apps |
+| ------------- | --------------- |
+| Create a [custom recognizer]({%slug speechtotextbutton-custom-recognizer%}) | Create a [custom recognizer]({%slug speechtotextbutton-custom-recognizer%}) |
+|  | Use the `RadSpeechRecognizer` |
 
-* Set the `SpeechRecognizerCreator` property of the `RadSpeechToTextButton` to `RadSpeechRecognizer` for **Unpackaged** apps:
+If you want to use the `RadSpeechRecognizer` on WinUI, set the `SpeechRecognizerCreator` property of the `RadSpeechToTextButton` to `RadSpeechRecognizer`:
 
-```csharp
+```C#
 this.speechToTextButton.SpeechRecognizerCreator = () => new RadSpeechRecognizer();
 ```
 
-* Create a [custom recognizer]({%slug speechtotextbutton-custom-recognizer%}) for **Packaged** and **Unpackaged** apps.
-
-* Use an **Unpackaged** app deployment model.
-
 ### Configure Speech Recognition
 
 Confirm the following are enabled in your WinUI app: