Sync with Kendo UI Professional

Author: kendo-bot

docs-aspnet/_config.yml

@@ -306,7 +306,7 @@ navigation:
  position: 60
  "html-helpers":
  title: "Components"
- position: 7
+ position: 8
  "html-helpers/datasource":
  title: "Data Source"
  "html-helpers/data-management":
@@ -487,16 +487,16 @@ navigation:
  title: "PDFViewer"
  "styles-and-layout":
  title: "Styles and Appearance"
- position: 8
+ position: 9
  "styles-and-layout/sass-themes":
  title: "SASS Themes"
  position: 2
  "styles-and-layout/less-themes":
  title: "LESS Themes"
  position: 3
  "ai":
- title: "AI Coding Assistant"
- position: 9
+ title: "AI Tools"
+ position: 3
  "globalization":
  title: "Globalization"
  position: 10

docs-aspnet/_contentTemplates/general-info.md

@@ -0,0 +1,27 @@
+#status-telerik-com
+
+## Telerik NuGet Feed Status
+
+Visit [status.telerik.com](https://status.telerik.com) to check the status of the Telerik NuGet server. The top section shows manually logged incidents with possible updates or workaround suggestions. The [**System Metrics** section](https://status.telerik.com/#system-metrics) provides real-time automated diagnostics.
+
+#end
+
+#identical-versions-note-core
+
+> The installed {{ site.product }} NuGet package and the required [client-side assets]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) must have identical versions.
+
+#end
+
+#identical-versions-note-mvc
+
+> The `Kendo.Mvc.dll` and the required [client-side assets]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) must have identical versions.
+
+#end
+
+#scripts-references-notes
+
+>* The `kendo.all.min.js` and `kendo.aspnetmvc.min.js` scripts must be loaded after the `jquery.min.js` script.
+>* `jQuery` must be loaded only once. Ensure there are no duplicate references elsewhere in the `_Layout`.
+>* Starting with version 2023.3.1010, the Kendo UI bundles do not include the jQuery library in their `js` directories and you can use any available jQuery source you prefer (https://jquery.com/download/).
+
+#end

docs-aspnet/_contentTemplates/get-started.md

@@ -0,0 +1,48 @@
+#generate-nuget-api-key
+
+As the Telerik NuGet server requires authentication, the first step is to obtain an API key that you will use instead of a password. Using an API key instead of a password is a more secure approach{% if site.core %}, especially when working with the .NET CLI or a `NuGet.Config` file{% endif %}.
+
+1. Go to the [API Keys](https://www.telerik.com/account/downloads/api-keys) page in your Telerik account.
+1. Click **Generate New Key +**.
+1. In the **Key Note** field, add a note that describes the API key.
+1. Click **Generate Key**.
+1. Select **Copy and Close**. Once you close the window, you can no longer copy the generated key. For security reasons, the **API Keys** page displays only a portion of the key.
+1. Store the generated NuGet API key as you will need it in the next steps. Whenever you need to authenticate your system with the Telerik NuGet server, use `api-key` as the username and your generated API key as the password.
+
+> API keys expire after two years. Telerik will send you an email when a key is about to expire, but we recommend that you set your own calendar reminder with information about where you used that key: file paths, project links, AzDO and GitHub Action variable names, and so on.
+
+#end
+
+#add-nuget-feed
+
+In this tutorial, you will use the [Telerik NuGet feed]({% slug nuget_install_aspnetmvc6_aspnetmvc%}) to download the {{ site.product_short }} components. This NuGet feed is private and requires you to authenticate with a NuGet API key.
+
+To generate your NuGet API key:
+
+1. Go to the [API Keys](https://www.telerik.com/account/downloads/api-keys) page in your Telerik account.
+
+1. Click **Generate New Key +**.
+
+1. In the **Key Note** field, add a note that describes the API key.
+
+1. Click **Generate Key**.
+
+1. Select **Copy and Close**. Once you close the window, you can no longer copy the generated key. For security reasons, the **API Keys** page displays only a portion of the key.
+
+1. Store the generated NuGet API key as you will need it in the next steps.
+
+Next, add the Telerik NuGet feed to Visual Studio:
+
+1. In Visual Studio and go to **Tools** > **NuGet Package Manager** > **Package Manager Settings**.
+
+1. Select **Package Sources** and then click the **+** button to add a new package source.
+
+1. Enter a **Name** for the new package source, for example, `telerik.com`.
+
+1. Add the `https://nuget.telerik.com/v3/index.json` URL as a **Source**. Click **OK**.
+
+![Add the Telerik NuGet Feed in Visual Studio](images/add-nuget-source.png)
+
+1. Whenever Visual Studio displays a dialog to enter credentials for `nuget.telerik.com`, use `api-key` as the username and your NuGet API key as the password.
+
+#end

docs-aspnet/_contentTemplates/issues-and-warnings.md

@@ -0,0 +1,11 @@
+#nuget-security-links
+
+You may find useful the following Microsoft articles on securing your NuGet feed setup and supply chain as general best practices:
+
+* <a href="https://devblogs.microsoft.com/nuget/lock-down-your-dependencies-using-configurable-trust-policies/" target="_blank">Lock down your dependencies using configurable trust policies - Blog Post</a>
+* <a href="https://devblogs.microsoft.com/nuget/how-to-scan-nuget-packages-for-security-vulnerabilities/" target="_blank">How to Scan NuGet Packages for Security Vulnerabilities - Blog Post</a>
+* <a href="https://docs.microsoft.com/en-us/nuget/concepts/security-best-practices" target="_blank">Best practices for a secure software supply chain - MSDN docs</a>
+
+Telerik provides signed NuGet packages that you can verify.
+
+#end

docs-aspnet/_contentTemplates/mvc/add-client-side-resources.md

@@ -2,76 +2,73 @@
 
 ## Including the Client-Side Resources
 
-Before you can use a Telerik UI component, you must include the theme, the jQuery script, and the Kendo UI scripts:
+To enable the Telerik UI for ASP.NET MVC components, you must add several [client-side]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) dependencies to the application, like scripts and a [theme file]({% slug sassbasedthemes_overview%})
 
-1. Go to `~\Views\Shared\_Layout.cshtml` and add the Kendo UI theme of your choice to the `<head>` of the document. Since Microsoft's project template uses Bootstrap, you can use the Kendo UI SASS Bootstrap theme to match it.
+Before adding a Telerik UI component, you must include the theme, the jQuery script, and the Kendo UI scripts:
+
+1. Go to `~\Views\Shared\_Layout.cshtml` and add the theme of your choice to the `<head>` of the document. Since ASP.NET Web Application template uses Bootstrap, you can use the [Telerik UI Bootstrap theme]({% slug sassbasedthemes_overview%}#built-in-themes) to match it:
 
 ```HTML
 <head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>@ViewBag.Title - My ASP.NET Application</title>
-@Styles.Render("~/Content/css")
-@Scripts.Render("~/bundles/modernizr")
-
-@* Add the Kendo SASS Bootstrap theme: *@
-<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
+...
+@Styles.Render("~/Content/css")
+@Scripts.Render("~/bundles/modernizr")
+
+@* Add the Telerik UI Bootstrap Main theme: *@
+<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
+...
 </head>
 ```
 
-1. In the `_Layout.cshtml` file, locate the `@Scripts.Render("~/bundles/jquery")` line in the `<body>` of the document and delete it. This jQuery script reference comes with the Microsoft ASP.NET Web Application template. 
-
-Removing this script is crucial because in the next step you add the jQuery script provided by Telerik. Having more than one script references causes errors. 
-
-1. Add the jQuery script to the `<head>` tag.
+1. The ASP.NET Web Application template comes with a jQuery script reference at the end of `_Layout.cshtml` file. Locate the `@Scripts.Render("~/bundles/jquery")` line in the `<body>` of the document and move it to the `<head>`. Alterantively, use the jQuery script hosted on the jQuery CDN.
 
 ```HTML
 <head>
-...
-<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
+...
+<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
 
-@* Add the jQuery script from the jQuery CDN: *@
-<script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
+@* Add the jQuery script from the jQuery CDN: *@
+<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
 </head>
 ```
-1. Add the Kendo UI scripts. The Kendo UI script files required by UI for ASP.NET MVC must be loaded in the `<head>` tag *after* the jQuery script.
+
+1. Add the required Kendo UI script files in the `<head>` tag after the `jQuery` script reference:
 
 ```HTML
 <head>
-...
-<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
-<script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
-
-@* Add the Kendo UI scripts: *@
-<script src="https://unpkg.com/jszip/dist/jszip.min.js"></script>
-<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.all.min.js"></script>
-<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.aspnetmvc.min.js"></script>
+...
+<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
+<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
+
+@* Add the Kendo UI scripts: *@
+<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.all.min.js"></script>
+<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.aspnetmvc.min.js"></script>
 </head>
 ```
-1. Finally, add the `bootstrap.min.js` script available in Microsoft's ASP.NET Web Application template, and the `<head>` will look like this.
+
+> The installed {{ site.product }} NuGet package and the required [client-side assets]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) must have identical versions.
+
+1. Finally, add the `bootstrap.min.js` script available in ASP.NET Web Application template. The `<head>` tag must contain the following sylesheets and scripts:
 
 ```HTML
-<head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>@ViewBag.Title - My Telerik MVC Application</title>
-@Styles.Render("~/Content/css")
-@Scripts.Render("~/bundles/modernizr")
-<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
-<script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
-<script src="https://unpkg.com/jszip/dist/jszip.min.js"></script>
-<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.all.min.js"></script>
-<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.aspnetmvc.min.js"></script>
-
-@* Add the bootstrap.min.js script: *@
-<script src="@Url.Content("~/Scripts/bootstrap.min.js")"></script>
+
+@Styles.Render("~/Content/css")
+@Scripts.Render("~/bundles/modernizr")
+<link href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/bootstrap/bootstrap-main.css" rel="stylesheet" type="text/css" />
+<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
+<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.all.min.js"></script>
+<script src="https://kendo.cdn.telerik.com/{{ site.mvcCoreVersion }}/js/kendo.aspnetmvc.min.js"></script>
+
+@* Add the bootstrap.min.js script: *@
+<script src="@Url.Content("~/Scripts/bootstrap.min.js")"></script>
 </head>
 ```
 >Always observe the following rules when adding client-side resources to your project:
-> * Put the Kendo UI script files (`kendo.all.min.js` and `kendo.aspnetmvc.min.js`) after the `jquery.min.js` script.
-> * A jQuery script must be loaded only once. It must be placed only in the `<head>` tag of the `_Layout.cshtml` file. Make sure there are no duplicate jQuery references elsewhere in the `_Layout` file.
-> * The Kendo UI scripts, the Kendo UI CSS file must use a compatible version of the theme, and the `Kendo.Mvc.dll` referenced in the project must be the same version as the Kendo UI script files.
+> * Register the Kendo UI script files (`kendo.all.min.js` and `kendo.aspnetmvc.min.js`) after the `jquery.min.js` script.
+> * The jQuery script must be loaded only once. It must be placed only in the `<head>` tag of the `_Layout.cshtml` file. Ensure there are no duplicate jQuery references elsewhere in the `_Layout` file.
+> * The Telerik UI for ASP.NET MVC version and the version of the included Telerik UI theme must be mutually compatible. For more information, refer to the [compatibility table]({% slug sass_themes_compatibility_aspnetmvc6_aspnetmvc %}).
+> * The `Kendo.Mvc.dll` and the referenced Kendo UI scripts must have identical versions.
 
-If you prefer to include the Kendo UI scripts and styles from a local source instead of CDNs, refer to the [Local Client-Side Resources]({% slug using_local_client_side_resources %}) article.
+If you prefer to include the client-side resources from a local source instead of CDNs, refer to the [Local Client-Side Resources]({% slug using_local_client_side_resources %}) article.
 
 #end