chore(SpeechToTextButton): apply changes based on review and polish the articles

Author: Tsvetomir-Hr

components/speechtotextbutton/appearance.md

@@ -10,15 +10,15 @@ position: 2
 
 # SpeechToTextButton Appearance
 
-You can customize the appearance of the `SpeechToTextButton` component by using its built-in parameters and CSS classes. The component supports the same appearance options as the standard Telerik Button.
+You can customize the appearance of the SpeechToTextButton component by using its built-in parameters and CSS classes. The component supports the same appearance options as the [Telerik UI for Blazor Button](slug:components/button/overview).
 
 ## Size
 
 You can increase or decrease the size of the button by setting the `Size` parameter to a member of the `Telerik.Blazor.ThemeConstants.Button.Size` class. 
 
 To review all available values for the `Size` parameter, see the [Button Size API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.ThemeConstants.Button.Size.html).
 
-**Example of Setting the Button Size**
+>caption Example of setting the Button Size
 
 <demo metaUrl="client/speechtotextbutton/size/" height="150"></demo>
 
@@ -28,7 +28,7 @@ The `FillMode` toggles the background and border of the TelerikSpeechToTextButto
 
 To review all available values for the `FillMode` parameter, see the [Button FillMode API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.ThemeConstants.Button.FillMode.html).
 
-**Example of Setting the Fill Mode**
+>caption Example of setting the FillMode
 
 <demo metaUrl="client/speechtotextbutton/fillmode/" height="150"></demo>
 
@@ -38,7 +38,7 @@ The color of the button is controlled through the `ThemeColor` parameter. You ca
 
 To review all available values for the `ThemeColor` parameter, see the [Button ThemeColor API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.ThemeConstants.Button.ThemeColor.html).
 
-**Example of Setting the Theme Color**
+>caption Example of setting the ThemeColor
 
 <demo metaUrl="client/speechtotextbutton/themecolor/" height="150"></demo>
 
@@ -48,23 +48,23 @@ The `Rounded` parameter applies the border-radius CSS rule to the button to achi
 
 To review all available values for the `Rounded` parameter, see the [Button Rounded API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.ThemeConstants.Button.Rounded.html).
 
-**Example of Setting the Rounded Parameter**
+>caption Example of Setting the Rounded parameter
 
 <demo metaUrl="client/speechtotextbutton/rounded/" height="150"></demo>
 
 ## Icon
 
-Set the `Icon` parameter to display an icon. You can use a predefined Telerik icon or a custom one.
+Set the `Icon` parameter to display an icon. You can use a predefined [Telerik icon](slug:common-features-icons) or a custom one.
 
-**Example of Customizing the Icon**
+>caption Example of customizing the default icon
 
 <demo metaUrl="client/speechtotextbutton/icon/" height="150"></demo>
 
 ## Custom Styles
 
 Use the `Class` parameter to apply custom CSS classes. You can further style the button by targeting these classes.
 
-**Example of Custom Styling**
+>caption Example of custom styling
 
 <demo metaUrl="client/speechtotextbutton/customstyle/" height="150"></demo>
 

components/speechtotextbutton/events.md

@@ -10,23 +10,23 @@ position: 3
 
 # SpeechToTextButton Events
 
-The `SpeechToTextButton` component emits events that notify you about speech recognition results, errors, and state changes. Use these events to update the UI, display messages, or process the recognized speech.
+The SpeechToTextButton component emits events that notify you about speech recognition results, errors, and state changes. Use these events to update the UI, display messages, or process the recognized speech.
 
 ## OnResult
 
 The `OnResult` event fires when the component recognizes speech and produces a result. Use this event to access the recognized phrases, alternatives, and confidence scores.
 
 To review all available properties of the event arguments for `OnResult`, see the [`SpeechToTextButtonResultEventArgs` API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.SpeechToTextButtonResultEventArgs.html).
 
-**Example: Displaying Recognized Alternatives and Confidence**
+>caption Example: Displaying recognized Alternatives and Confidence
 
 <demo metaUrl="client/speechtotextbutton/onresult/" height="300"></demo>
 
 ## OnStart and OnEnd
 
 The `OnStart` event fires when speech recognition starts. The `OnEnd` event fires when speech recognition ends. Use these events to update the UI or track the recognition state.
 
-**Example: Indicating Listening State**
+>caption Example: Indicating listening state
 
 <demo metaUrl="client/speechtotextbutton/onstartend/" height="300"></demo>
 

components/speechtotextbutton/integration.md

@@ -10,17 +10,16 @@ position: 4
 
 # SpeechToTextButton Integration
 
-Integrate the `SpeechToTextButton` component with forms, input fields, and other UI elements to provide voice input capabilities.
+Integrate the SpeechToTextButton component with forms, input fields, and other UI elements to provide voice input capabilities.
 
 ## Binding Recognized Text to an Input Field
 
-Use the `OnResult` event to update an input field with the recognized text.
+Use the `OnResult` event to update an input field with the recognized text. For example, you can enable users to fill out a feedback form by speaking instead of typing. When the user clicks the SpeechToTextButton, the component captures their speech. It then updates the value of a [TelerikTextArea](slug:textarea-overview) with the recognized text.
 
-**Example of Binding Recognized Text to an TelerikTextArea**
+>caption Example of binding the recognized text to an TelerikTextArea
 
 <demo metaUrl="client/speechtotextbutton/integration/" height="250"></demo>
 
-
 ## See Also
 
 - [AI Model Voice Transcription Intergration](https://github.com/telerik/blazor-ui/tree/master/common/microsoft-extensions-ai-integration/SpeechToTextIntegration)

components/speechtotextbutton/overview.md

@@ -10,35 +10,35 @@ position: 1
 
 # Blazor SpeechToTextButton Overview
 
-The `SpeechToTextButton` component enables speech recognition in Blazor applications. It provides a button that users can select to start and stop speech recognition. The component converts spoken words into text and emits events with the recognized results.
+The [Blazor SpeechToTextButton component](https://www.telerik.com/blazor-ui/speech-to-text-button) enables speech recognition in Blazor applications. It provides a button that users can select to start and stop speech recognition. The component converts spoken words into text and emits events with the recognized results.
 
-Use the `SpeechToTextButton` component to add voice input capabilities to forms, search bars, chat interfaces, and other scenarios that require speech-to-text functionality.
+Use the SpeechToTextButton component to add voice input capabilities to forms, search bars, chat interfaces, and other scenarios that require speech-to-text functionality.
 
 ## Basic Usage
 
-The following example demonstrates how to add the `SpeechToTextButton` to a Blazor page and handle the recognition result.
+The following example demonstrates how to add the SpeechToTextButton to a Blazor page and handle the recognition result.
 
-**Example of Using the SpeechToTextButton**
+>caption Example of using the SpeechToTextButton
 
 <demo metaUrl="client/speechtotextbutton/overview/" height="200"></demo>
 
 ## Appearance
 
-You can customize the appearance of the `SpeechToTextButton` by setting parameters such as `Icon`, and `Class`. For more details and examples, refer to [SpeechToTextButton Appearance](slug:speechtotextbutton-appearance).
+You can customize the appearance of the SpeechToTextButton by setting parameters such as `Icon`, and `Class`. For more details and examples, refer to [SpeechToTextButton Appearance](slug:speechtotextbutton-appearance).
 
 ## Events
 
-The `SpeechToTextButton` component emits several events that you can handle. For more details, refer to [SpeechToTextButton Events](slug:speechtotextbutton-events).
+The SpeechToTextButton component emits several events that you can handle. For more details, refer to [SpeechToTextButton Events](slug:speechtotextbutton-events).
 
 ## SpeechToTextButton Parameters
 
-To review all available parameters for the `SpeechToTextButton` component, see the [SpeechToTextButton API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton#parameters).
+To review all available parameters for the SpeechToTextButton component, see the [SpeechToTextButton API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton#parameters).
 
 ## SpeechToTextButton Reference and Methods
 
-The `SpeechToTextButton` component exposes several public methods that you can call from your code. For a full list and details, see the [SpeechToTextButton API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton#methods).
+The SpeechToTextButton component exposes several public methods that you can call from your code. For a full list and details, see the [SpeechToTextButton API Reference](https://docs.telerik.com/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton#methods).
 
-**Example of Calling a Method by Reference**
+>caption Example of Calling a Method by Reference
 
 <div class="skip-repl"></div>
 ````RAZOR
@@ -54,7 +54,7 @@ The `SpeechToTextButton` component exposes several public methods that you can c
 
 ## Supported Browsers
 
-The `SpeechToTextButton` component relies on the Web Speech API. For a list of supported browsers, refer to the [Web Speech API documentation](https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API#browser_compatibility).
+The SpeechToTextButton component relies on the Web Speech API. For a list of supported browsers, refer to the [Web Speech API documentation](https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API#browser_compatibility).
 
 ## Next Steps
 
@@ -63,8 +63,8 @@ The `SpeechToTextButton` component relies on the Web Speech API. For a list of s
 
 ## See Also
 
-- [SpeechToTextButton Live Demo](https://demos.telerik.com/blazor-ui/speechtotextbutton/overview)
-- [SpeechToTextButton API Reference](/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton)
-- [SpeechToTextButton Events](slug:speechtotextbutton-events)
-- [SpeechToTextButton Appearance](slug:speechtotextbutton-appearance)
-- [SpeechToTextButton Integration](slug:speechtotextbutton-integration)
+* [SpeechToTextButton Live Demo](https://demos.telerik.com/blazor-ui/speechtotextbutton/overview)
+* [SpeechToTextButton API Reference](/blazor-ui/api/Telerik.Blazor.Components.TelerikSpeechToTextButton)
+* [SpeechToTextButton Events](slug:speechtotextbutton-events)
+* [SpeechToTextButton Appearance](slug:speechtotextbutton-appearance)
+* [SpeechToTextButton Integration](slug:speechtotextbutton-integration)