Merge branch 'master' into update-dynamic-tabs

Author: dimodi

_contentTemplates/common/ai-coding-assistant.md

@@ -0,0 +1,3 @@
+#number-of-requests
+A Telerik [Subscription license](https://www.telerik.com/purchase/faq/licensing-purchasing) is recommended in order to use the Telerik Blazor AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a [limited number of requests per year](slug:ai-overview#number-of-requests).
+#end

ai/copilot-extension.md

@@ -55,15 +55,7 @@ The following list describes how your prompts may look like:
 
 ## Number of Requests
 
-> The usage limits below will take place after June 28, 2025. Until then, each customer with an active commercial or trial license can make up to 300 daily requests.
-
-The Telerik Blazor Copilot extension allows the following maximum number of requests, depending on your [Telerik license type](https://www.telerik.com/purchase/faq/licensing-purchasing):
-
-* Perpetual licenses: 50 requests per year
-* Subscription licenses: virtually unlimited number of requests with a fair use threshold of 300 requests per day
-* Trial licenses: 300 requests per trial per year. Activating the same trial for a new release does not grant additional 300 requests.
-
-> All Telerik AI tools share a single request limit for your Telerik account. For example, the Telerik Copilot extension and the Telerik MCP server both take up from the same usage quota.
+@[template](/_contentTemplates/common/ai-coding-assistant.md#number-of-requests)
 
 ## See Also 
 

ai/mcp-server.md

@@ -167,20 +167,13 @@ The following list describes how your prompts may look like:
 * "Telerik Generate a ComboBox for Blazor that shows a list of products. Create a Product class and generate sample data."
 * "Telerik Show me sample code for a Blazor Grid with virtual scrolling for the rows and columns."
 
-
 ## Number of Requests
 
-> The usage limits below will take place after June 28, 2025. Until then, each customer with an active commercial or trial license can make up to 300 daily requests.
-
-The Telerik Blazor MCP Server allows the following maximum number of requests, depending on your [Telerik license type](https://www.telerik.com/purchase/faq/licensing-purchasing):
+@[template](/_contentTemplates/common/ai-coding-assistant.md#number-of-requests)
 
-* Perpetual licenses: 50 requests per year
-* Subscription licenses: virtually unlimited number of requests with a fair use threshold of 300 requests per day
-* Trial licenses: 300 requests per trial per year. Activating the same trial for a new release does not grant additional 300 requests.
+## Connect to Local AI Model
 
-> One prompt may trigger several requests to the MCP server, depending on the complexity.
->
-> All Telerik AI tools share a single request limit for your Telerik account. For example, the Telerik MCP server and the Telerik Copilot extension both take up from the same usage quota.
+You can use the Telerik Blazor MCP server with local large language models (LLM). For example, run your local model through [Ollama](https://ollama.com) and use a third-party package such as [MCP-LLM Bridge](https://github.com/patruff/ollama-mcp-bridge) to connect the model to the Telerik MCP server. This will allow you to use the Telerik AI Coding Assistant without a cloud-based AI model.
 
 ## See Also 
 

ai/overview.md

@@ -29,11 +29,32 @@ To use the Telerik Blazor AI Coding Assistant, you need:
 * A [Telerik user account](https://www.telerik.com/account/).
 * An active [DevCraft or Telerik UI for Blazor license](https://www.telerik.com/purchase/blazor-ui) or a [Telerik UI for Blazor trial](https://www.telerik.com/blazor-ui).
 * A [Blazor application that includes Telerik UI for Blazor](slug:blazor-overview#getting-started).
+* @[template](/_contentTemplates/common/ai-coding-assistant.md#number-of-requests)
 
-> A Telerik [Subscription license](https://www.telerik.com/purchase/faq/licensing-purchasing) is recommended in order to use the Telerik Blazor AI Coding Assistant:
-> 
-> * Subscription license holders can make an unlimited number of requests.
-> * Perpetual license holders and trial users have a limited number of requests per year.
+## Number of Requests
+
+> The usage limits below will take place after June 28, 2025. Until then, each customer with an active commercial or trial license can make up to 300 daily requests.
+
+The Telerik Blazor AI Conding Assistant allows the following maximum number of requests, depending on your [Telerik license type](https://www.telerik.com/purchase/faq/licensing-purchasing):
+
+* Perpetual licenses: 50 requests per year
+* Subscription licenses: virtually unlimited number of requests with a fair use threshold of 300 requests per day
+* Trial licenses: 300 requests per trial per year. Activating the same trial for a new release does not grant additional 300 requests.
+
+> All Telerik AI tools share a single request limit for your Telerik account. For example, the [Telerik Copilot extension](slug:ai-copilot-extension) and the [Telerik MCP server](slug:ai-mcp-server) both take up from the same usage quota.
+> When using the Telerik MCP server, one prompt may trigger several requests, depending on the prompt complexity.
+
+## Privacy
+
+The Telerik Blazor AI Coding Assistant operates under the following conditions:
+
+* The Assistant does not have access to your workspace and application code. Note that when using the Telerik MCP server (or any other MCP server), the LLM generates parameters for the MCP server request, which may include parts of your application code.
+* The Assistant does not use your prompts to train Telerik AI models.
+* The Assistant does not generate the actual responses and has no access to these responses. The Assistant only provides a better context that helps your selected model (for example, GPT, Gemini, Claude) provide better responses.
+* The Assistant does not associate your prompts to your Telerik user account. Your prompts and generated context are anonymized and stored for statistical and troubleshooting purposes.
+* The Assistant stores metrics about how often and how much you use it in order to ensure compliance with the [allowed number of requests that correspond to your current license](#number-of-requests).
+
+Make sure to also get familiar with the terms and privacy policy of your selected AI model and AI client.
 
 ## Next Steps
 

components/autocomplete/data-bind.md

@@ -92,57 +92,7 @@ To bind the AutoComplete to a model:
 }
 ````
 
-## Considerations
-
-### Reference
-
-The AutoComplete is a generic component and its type depends on the type of its `Data` and `Value`.
-
-<div class="skip-repl"></div>
-````RAZOR String
-@*Reference when binding to a string collection*@
-
-<TelerikAutoComplete @ref="@AutoCompleteRef"
-                     Data="@Suggestions"
-                     @bind-Value="@AutoCompleteValue" />
-
-@code{
-    private TelerikAutoComplete<string> AutoCompleteRef { get; set; }
-
-    private string AutoCompleteValue { get; set; }
-
-    private List<string> Suggestions { get; set; } = new List<string> { "first", "second", "third" };
-}
-````
-````RAZOR Model
-@*Reference when binding to a model collection*@
-
-<TelerikAutoComplete @ref="@AutoCompleteRef"
-                     Data="@Suggestions" 
-                     @bind-Value="@AutoCompleteValue"
-                     ValueField="@( nameof(SuggestionsModel.Suggestion) )" />
-
-@code{
-    private TelerikAutoComplete<SuggestionsModel> AutoCompleteRef { get; set; }
-
-    private string AutoCompleteValue { get; set; }
-
-    private List<SuggestionsModel> Suggestions { get; set; } = new List<SuggestionsModel>
-    {
-        new SuggestionsModel { Suggestion = "first", SomeOtherField = 1 },
-        new SuggestionsModel { Suggestion = "second", SomeOtherField = 2 },
-        new SuggestionsModel { Suggestion = "third", SomeOtherField = 3 }
-    };
-
-    public class SuggestionsModel
-    {
-        public string Suggestion { get; set; }//the auto complete needs only the string field
-        public int SomeOtherField { get; set; }
-    }
-}
-````
-
-### Missing Data
+## Missing Data
 
 The AutoComplete is, essentially, a textbox. This means that its `Value` is always a string and it is up to you to bind and/or use it. The `Data` parameter, however, is required for the functionality of the component, and it must never be `null`. If there are no suggestions that you wish to provide to the user, consider using a regular TextBox, or creating an empty collection.
 

components/autocomplete/overview.md

@@ -145,9 +145,7 @@ The AutoComplete provides the following popup settings:
 
 ## AutoComplete Reference and Methods
 
-The AutoComplete is a generic component and its type is determined by the type of the model you use as its data source. You can find examples in the [Data Bind - Considerations](slug:autocomplete-databind#considerations) article.
-
-Add a reference to the component instance to use the [AutoComplete's methods](slug:Telerik.Blazor.Components.TelerikAutoComplete-1).
+Add a reference to the component instance to use the [AutoComplete's methods](slug:Telerik.Blazor.Components.TelerikAutoComplete-1). Note that the [AutoComplete is a generic component](slug:common-features-data-binding-overview#component-type).
 
 @[template](/_contentTemplates/dropdowns/methods.md#methods-list)
 

components/combobox/data-bind.md

@@ -23,7 +23,6 @@ There are also some considerations you may find useful, such as showing the `Pla
 
 * [Considerations](#considerations)
 	* [Value Out of Range](#value-out-of-range)
-	* [Component Reference](#component-reference)
 	* [Missing Value or Data](#missing-value-or-data)
 
 ## Strings and Value Types
@@ -105,7 +104,7 @@ To bind the ComboBox to a model:
 
 ## Considerations
 
-The ComboBox component attempts to infer the type of its model and value based on the provided `Data` and initial `Value`. This affects the way its [reference is obtained](#component-reference) and what happens [if you can't provide data or a value](#missing-value-or-data). Providing a [value that is not in the data source](#value-out-of-range) needs to be taken into account be the app, because the component will not change it.
+The ComboBox component attempts to infer the type of its model and value based on the provided `Data` and initial `Value`. This affects the way its [reference is obtained](slug:common-features-data-binding-overview#component-type) and what happens [if you can't provide data or a value](#missing-value-or-data). Providing a [value that is not in the data source](#value-out-of-range) needs to be taken into account by the app, because the component will not change it.
 
 ### Value Out of Range
 
@@ -119,63 +118,6 @@ Handling such "unexpected" values is up to the application - for example, throug
 
 When `AllowCustom="true"`, what the user types in the input will be set to the `Value` of the component regardless of the data source.
 
-### Component Reference
-
-The ComboBox is a generic component and its type depends on the type of its `Data` and `Value`.
-
-<div class="skip-repl"></div>
-````RAZOR String
-@*ComboBox reference when binding to a string collection*@
-
-<TelerikComboBox @ref="ComboBoxRef"
-                 Data="@ComboBoxData"
-                 Value="@ComboBoxValue">
-</TelerikComboBox>
-
-@code {
-    private TelerikComboBox<string, string>? ComboBoxRef { get; set; }
-
-    private List<string> ComboBoxData = new List<string>() { "first", "second", "third" };
-
-    private string ComboBoxValue { get; set; } = string.Empty;
-
-    protected override void OnInitialized()
-    {
-        ComboBoxValue = "third";
-    }
-}
-````
-````RAZOR Model
-@*ComboBox reference when binding to a model collection*@
-
-<TelerikComboBox @ref="@ComboBoxRef"
-                 Data="@ComboBoxData"
-                 @bind-Value="@ComboBoxValue"
-                 TextField="@nameof(ComboBoxItem.MyTextField)"
-                 ValueField="@nameof(ComboBoxItem.MyValueField)">
-</TelerikComboBox>
-
-@code {
-    private TelerikComboBox<ComboBoxItem, int>? ComboBoxRef { get; set; }
-
-    private IEnumerable<ComboBoxItem> ComboBoxData = Enumerable.Range(1, 20)
-        .Select(x => new ComboBoxItem { MyTextField = "Item " + x, MyValueField = x });
-
-    private int ComboBoxValue { get; set; }
-
-    protected override void OnInitialized()
-    {
-        ComboBoxValue = 3;
-    }
-
-    public class ComboBoxItem
-    {
-        public int MyValueField { get; set; }
-        public string MyTextField { get; set; } = string.Empty;
-    }
-}
-````
-
 ### Missing Value or Data
 
 In case you cannot provide strongly-typed `Value` or `Data` at compile time, you need to set the corresponding type properties to the `TItem` and `TValue` properties as shown below.

components/combobox/overview.md

@@ -145,9 +145,8 @@ The ComboBox provides the following popup settings:
 
 ## ComboBox Reference and Methods
 
-The ComboBox is a generic component and its type is determined by the type of the model you pass to it, and the type of its value field. You can find examples in the [Data Bind - Considerations](slug:components/combobox/databind#considerations) article.
+Add a reference to the component instance to use the [ComboBox's methods](slug:Telerik.Blazor.Components.TelerikComboBox-2). Note that the [ComboBox is a generic component](slug:common-features-data-binding-overview#component-type).
 
-Add a reference to the component instance to use the [ComboBox's methods](slug:Telerik.Blazor.Components.TelerikComboBox-2).
 
 @[template](/_contentTemplates/dropdowns/methods.md#methods-list)
 

components/dropdownlist/data-bind.md

@@ -23,7 +23,6 @@ There are also some considerations you may find useful, such as showing the `Def
 
   * [Considerations](#considerations)
     * [Value Out of Range](#value-out-of-range)
-    * [Component Reference](#component-reference)
     * [Missing Value or Data](#missing-value-or-data)
 
 ## Strings or Value Types
@@ -93,7 +92,7 @@ To bind the DropDownList to a model:
 
 ## Considerations
 
-The DropDownList component attempts to infer the type of its model and value based on the provided `Data` and initial `Value`. This affects the way its [reference is obtained](#component-reference) and what happens [if you can't provide data or a value](#missing-value-or-data). Providing a [value that is not in the data source](#value-out-of-range) needs to be taken into account be the app, because the component will not change it.
+The DropDownList component attempts to infer the type of its model and value based on the provided `Data` and initial `Value`. This affects the way its [reference is obtained](slug:common-features-data-binding-overview#component-type) and what happens [if you can't provide data or a value](#missing-value-or-data). Providing a [value that is not in the data source](#value-out-of-range) needs to be taken into account by the app, because the component will not change it.
 
 ### Value Out of Range
 
@@ -102,57 +101,6 @@ When the `Value` the application provides does not match any of the values prese
 If you have set the `DefaultText` and the `Value` matches the `default` value of the type (for example, `0` for an `int` or `null` for an `int?` or `string`), you will see the `DefaultText`. A `Value` that is non-`default` will not show the `DefaultText`.
 
 Handling such "unexpected" values is up to the application - for example, through defensive checks, or through form validation, or by first checking what is present in the data source before setting a new `Value`.
- 
-### Component Reference
-
-The DropDownList is a generic component and its type depends on the type of its `Data` and `Value`.
-
-<div class="skip-repl"></div>
-````RAZOR String
-<TelerikDropDownList @ref="@DropDownListRef"
-                     Data="@DropDownListData"
-                     @bind-Value="DropDownListValue" />
-
-@code {
-    private TelerikDropDownList<string, string>? DropDownListRef { get; set; }
-
-    private List<string> DropDownListData = new List<string>() { "first", "second", "third" };
-
-    private string DropDownListValue { get; set; } = string.Empty;
-
-    protected override void OnInitialized()
-    {
-        DropDownListValue = "second";
-    }
-}
-````
-````RAZOR Model
-<TelerikDropDownList @ref="@DropDownListRef"
-                     Data="@DropDownListData"
-                     @bind-Value="DropDownListValue"
-                     TextField="@nameof(DropDownListItem.Text)"
-                     ValueField="@nameof(DropDownListItem.Value)" />
-
-@code {
-    private TelerikDropDownList<DropDownListItem, int>? DropDownListRef { get; set; }
-
-    private int DropDownListValue { get; set; }
-
-    private IEnumerable<DropDownListItem> DropDownListData = Enumerable.Range(1, 20)
-        .Select(x => new DropDownListItem { Text = $"Item {x}", Value = x });
-
-    protected override void OnInitialized()
-    {
-        DropDownListValue = 3;
-    }
-
-    public class DropDownListItem
-    {
-        public int Value { get; set; }
-        public string Text { get; set; } = string.Empty;
-    }
-}
-````
 
 ### Missing Value or Data
 

components/dropdownlist/overview.md

@@ -145,9 +145,8 @@ The DropDownList provides the following popup settings:
 
 ## DropDownList Reference and Methods
 
-The DropDownList is a generic component and its type comes from the model it is bound to and from the value field type. See the [Component Reference](slug:components/dropdownlist/databind#component-reference) section in the Data Binding article for details and examples.
+Add a reference to the component instance to use the [DropDownList's methods](slug:Telerik.Blazor.Components.TelerikDropDownList-2). Note that the [DropDownList is a generic component](slug:common-features-data-binding-overview#component-type).
 
-Add a reference to the component instance to use the [DropDownList's methods](slug:Telerik.Blazor.Components.TelerikDropDownList-2).
 
 @[template](/_contentTemplates/dropdowns/methods.md#methods-list)