merge master into dev

_contentTemplates/common/nuget.md

@@ -21,15 +21,15 @@ Visit <a href="https://status.telerik.com" target="_blank">status.telerik.com</a
 
 1. Select the **DOWNLOADS** tab and then **Manage NuGet Keys**.
 
-    ![Manage NuGet Keys](../images/manage-nuget-keys.png)
+    ![Manage NuGet Keys](../../installation/images/manage-nuget-keys.png)
 
 1. To create a new key, select the **Generate New Key** button.
 
 1. Enter a name for the NuGet Key, and then select **Generate Key**.
 
 1. To copy the key, select **Copy and Close**. Once you close the window, you can no longer copy the generated key. For security reasons, the **NuGet Keys** page displays only a portion of the key.
 
-    ![Copy Generated NuGet Key](../images/copy-nuget-key.png)
+    ![Copy Generated NuGet Key](../../installation/images/copy-nuget-key.png)
 
 1. Store the generated NuGet API key as you will need it in the next step.
 #end

_contentTemplates/common/supported-platforms.md

@@ -0,0 +1,10 @@
+#supported-platforms
+You can develop applications with Telerik UI for .NET MAUI for the following platforms:
+
+| Target Platform | Supported Version |
+| ------------- | --------------- |
+| Android | 5.0 (API 21) or later |
+| iOS | 11 or higher |
+| macOS | 11 or higher, using Mac Catalyst |
+| Windows* | Windows 11 and Windows 10 version 1809 or later, using Windows UI Library (WinUI) 3 |
+#end

controls/autocomplete/xamarin-migration.md

@@ -32,11 +32,14 @@ When migrating the AutoComplete from Xamarin to .NET MAUI, consider the followin
 | `WatermarkText` | `Placeholder` |
 | `WatermarkTextColor` | `PlaceholderColor` |
 | `SuggestionItemTextColor` | `SuggestionItemHighlightTextColor` |
+| `SuggestionItemTemplate` (`DataTemplate`) with `ViewCell` inside the Template | `SuggestionItemTemplate` (`DataTemplate`) |
 | `SuggestionItemLabel` | `RadHighlightLabel` |
 | `ImagePath` | N/A |
 | `CompletionMode` (of type `CompletionMode`) | `CompletionMode` (of type `AutoCompleteCompletionMode`) |
 | `SuggestionViewPosition` (of type `PopupPosition`) | `SuggestionViewPosition` (of type `AutoCompletePopupPosition`) |
 | `SuggestMode` of type(`SuggestMode`) | `SuggestMode` (of type `AutoCompleteSuggestMode`) |
+| `FilteredItemsChangedEventArgs` in namespace `Telerik.XamarinForms.Input.AutoComplete` | `FilteredItemsChangedEventArgs` in namespace `Telerik.Maui.Controls.AutoComplete` |
+| `SuggestionItemSelectedEventArgs` in namespace `Telerik.XamarinForms.Input.AutoComplete` | `SuggestionItemSelectedEventArgs` in namespace `Telerik.Maui.Controls.AutoComplete` |
 
 ## See Also
 

controls/button/getting-started.md

@@ -1,6 +1,6 @@
 ---
 title: Getting Started
-page_title: .NET MAUI Button Documentation - Getting Started
+page_title: Getting Started with .NET MAUI Button
 description: Get started with the Telerik UI for .NET MAUI Button control and add the control to your .NET MAUI project.
 position: 1
 slug: button-getting-started
@@ -10,6 +10,10 @@ slug: button-getting-started
 
 This guide provides the information you need to start using the Telerik UI for .NET MAUI Button by adding the control to your project.
 
+{% if site.has_cta_panels == true %}
+{% include cta-panel-maui-overview.html %}
+{% endif %}
+
 This is the default look of the `RadButton` control:
 
 ![.NET MAUI Button Default Look](images/button-default-look.png)

controls/button/overview.md

@@ -14,6 +14,15 @@ The Telerik UI for .NET MAUI Button control enhances the functionality of the st
 
 ![.NET MAUI Button Overview](images/button-overview.png "Button for .NET MAUI")
 
+## .NET MAUI Button Video Tutorial
+
+If you prefer video instructions, watch the Getting Started with the MAUI Button video tutorial. It covers the following topics:
+* Installing the Telerik UI for .NET MAUI.
+* Setup a sample demo project.
+* Add a Button control to the project.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/WQe9qcoURRk?si=3z0OPOMJZKCxZw7O" title="Getting Started with Telerik UI for .NET MAUI: Installation and First Control Demo with Button" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
 ## Key Features of the .NET MAUI Button
 
 * [Content alignment]({% slug button-configuration%})&mdash;The Button enables you to control the horizontal and vertical positioning of its content.

controls/chart/overview.md

@@ -16,6 +16,14 @@ The intuitive object model and public API allow complex charts to be set up eith
 
 ![.NET MAUI Chart Overview](images/chart-overview.png)
 
+## .NET MAUI Chart Video Tutorial
+
+If you prefer video instructions, watch this short MAUI Chart video tutorial. It covers to following topics:
+* MAUI Chart anatomy—different Chart types, series, axis, labels, and more.
+* Add .NET MAUI Chart to the project.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/fWsZRAb0s-8?si=3l0glUh8zOjmfr2r" title="Building Interactive Charts with Telerik UI for .NET MAUI: Setup, Categories, and Labels" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
 ## Chart Types
 
 The Telerik UI for .NET MAUI Chart provides the Cartesian and the Pie Charts as well as a number of series, which enable you to visualize different types of data in various ways and depending on your preferences and requirements.

controls/combobox/keyboard-support.md

@@ -26,6 +26,71 @@ The following table lists the actions and keyboard combinations that are availab
 
 >On MacOS when `IsEditable` property of the ComboBox is `True`, `Command` key should be pressed to enable the previously described hotkeys.
 
+To enable the keyboard support when the drop-down is opened and when setting the custom item and selected item templates in ComboBox for .NET MAUI, wrap the content of the templates in a `RadComboBoxItem`. Define the necessary visual states of the `RadComboBoxItem`, specifically `MouseOver` and `Highlighted`.
+
+Here is a sample ComboBox definition in XAML:
+
+```XAML
+<telerik:RadComboBox ItemsSource="{Binding Items}" 
+                     DisplayMemberPath="Name" 
+                     x:Name="combo"
+                     Placeholder="Select City">
+    <telerik:RadComboBox.ItemTemplate>
+        <DataTemplate>
+            <telerik:RadComboBoxItem>
+                <VisualStateManager.VisualStateGroups>
+                    <VisualStateGroup x:Name="CommonStates">
+                        <VisualState x:Name="Normal"/>
+                        <VisualState x:Name="MouseOver">
+                            <VisualState.Setters>
+                                <Setter Property="telerik:RadComboBoxItem.BackgroundColor" Value="LightGray"/>
+                            </VisualState.Setters>
+                        </VisualState>
+                        <VisualState Name="Highlighted">
+                            <VisualState.Setters>
+                                <Setter Property="telerik:RadComboBoxItem.BackgroundColor" Value="LightGray" />
+                            </VisualState.Setters>
+                        </VisualState>
+                    </VisualStateGroup>
+                </VisualStateManager.VisualStateGroups>
+                <Label Text="{Binding Name}"
+                       Padding="8, 7, 0, 7"
+                       TextColor="Black"/>
+            </telerik:RadComboBoxItem>
+        </DataTemplate>
+    </telerik:RadComboBox.ItemTemplate>
+    <telerik:RadComboBox.SelectedItemTemplate>
+        <DataTemplate>
+            <telerik:RadComboBoxItem>
+                <VisualStateManager.VisualStateGroups>
+                    <VisualStateGroup x:Name="CommonStates">
+                        <VisualState x:Name="Normal"/>
+                        <VisualState x:Name="MouseOver">
+                            <VisualState.Setters>
+                                <Setter Property="telerik:RadComboBoxItem.BackgroundColor" Value="LightGray"/>
+                            </VisualState.Setters>
+                        </VisualState>
+                        <VisualState Name="Highlighted">
+                            <VisualState.Setters>
+                                <Setter Property="telerik:RadComboBoxItem.BackgroundColor" Value="LightCoral" />
+                            </VisualState.Setters>
+                        </VisualState>
+                    </VisualStateGroup>
+                </VisualStateManager.VisualStateGroups>
+                <VerticalStackLayout>
+                    <Label Text="{Binding Name}"
+                           Padding="8, 7, 0, 7"
+                           TextColor="Black"/>
+                    <Label Text="{Binding Population}"
+                           FontSize="12"
+                           Padding="8, 7, 0, 7"/>
+                </VerticalStackLayout>
+            </telerik:RadComboBoxItem>
+        </DataTemplate>
+    </telerik:RadComboBox.SelectedItemTemplate>
+</telerik:RadComboBox>
+```
+
 ## See Also
 
 - [Edit Mode & Search]({%slug combobox-editmode-and-search%}) 

controls/combobox/templates.md

@@ -18,6 +18,8 @@ If the default templates of the control do not suit your needs, you can define c
 
 To customize the content inside the input area when an item is selected and the `DisplayMemberPath` property is not set, use the [`SelectionBoxTemplate`](%slug combobox-templates%). The `SelectionBoxTemplate` applies when the `SelectionMode` is `Single` and the control's `IsEditable` property is set to `false`.
 
+To enable the [keyboard navigation support]({%slug combobox-keyboard-support%}) when the drop-down is opened and when setting the custom item and selected item templates in ComboBox for .NET MAUI, wrap the content of the templates in a `RadComboBoxItem`. Define the necessary visual states of the `RadComboBoxItem`, specifically `MouseOver` and `Highlighted`.
+
 ### Example with ItemTemplate and SelectedItemTemplate
 
 **1.** Define the [.NET MAUI ComboBox]({%slug combobox-overview%}) in XAML:

controls/dataform/overview.md

@@ -12,6 +12,16 @@ The Telerik UI for .NET MAUI DataForm is a customizable component allowing you t
 
 ![.NET MAUI DataForm Overview](images/dataform-overview.png)
 
+## .NET MAUI DataForm Video Tutorial
+
+If you prefer video instructions, watch this short MAUI DataForm video tutorial. It covers to following topics:
+* Build dynamic forms for data collection in a .NET MAUI app.
+* DataForm visual structure.
+* Built-in Editors.
+* Options to commit data.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/FACbowe4Klg?si=pZmy1yAGIe04j43D" title="Working with DataForm in Telerik UI for .NET MAUI: Setup, Editors, and Commit Modes" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
 ## Key Features of the .NET MAUI DataForm
 
 * [Built-in editors]({%slug dataform-editors%})&mdash;DataForm provides a set of built-in editors for the available primitive types such as `numeric`, `string`, `boolean`, `enumerations`, `DateTime`, `TimeSpan`. The control detects the types of the data object’s properties and automatically displays the proper editor.  

controls/datagrid/events.md

@@ -3,8 +3,8 @@ title: Events
 page_title: .NET MAUI DataGrid Documentation - Events
 description: "Learn about the Telerik UI for .NET MAUI DataGrid events and how to achieve various scenarios upon user interaction such as loading content on demand, binding to data, modifying group collections, and more."
 position: 14
-slug: datagrid-events
 tags: events
+slug: datagrid-events
 ---
 
 # .NET MAUI DataGrid Events

controls/datagrid/getting-started.md

@@ -12,7 +12,7 @@ This guide provides the information you need to start using the [Telerik UI for
 
 At the end, you will achieve the following result.
 
-![DataGrid Getting Started](images/datagrid-getting-started.png)
+![.NET MAUI DataGrid Getting Started](images/datagrid-getting-started.png)
 
 ## Prerequisites
 

controls/datagrid/load-on-demand.md

@@ -82,7 +82,7 @@ You have to set it to the `LoadOnDemandRowStyle` property of the DataGrid:
 
 >caption Row appearance after setting the `LoadOnDemandRowStyle` property
 
-![DataGrid LoadOnDemand Row Style](images/datagrid-rowstyle.png)
+![.NET MAUI DataGrid LoadOnDemand Row Style](images/datagrid-rowstyle.png)
 
 ### Load-More-Button Row Template
 
@@ -98,7 +98,7 @@ The following example shows how to set the property:
 
 >caption Row appearance after setting the `LoadOnDemandRowTemplate`
 
-![DataGrid LoadOnDemand Row Style](images/datagrid-rowtemplate.png)
+![.NET MAUI DataGrid LoadOnDemand Row Style](images/datagrid-rowtemplate.png)
 
 ## Additional Resources
 - [.NET MAUI DataGrid Product Page](https://www.telerik.com/maui-ui/datagrid)