Sync with Kendo UI Professional

Author: kendo-bot

.github/ISSUE_TEMPLATE/bug-report.md renamed to .github/ISSUE_TEMPLATE.md

@@ -1,12 +1,3 @@
----
-name: Bug Report
-about: Log new bug
-title: ''
-labels: ''
-assignees: ''
-
----
-
 ### Bug report
 
 **For Support request - Please do not submit support request here, instead see the** [Kendo UI Premium Forums](http://www.telerik.com/forums/kendo-ui) or our [support system](http://www.telerik.com/support) **at Telerik.com** !
@@ -24,12 +15,10 @@ Provide additional information if the steps for reproducing the faulty behavior
 ### Expected/desired behavior
 Explain what the expected behavior of the functionality is
 
-### TicketID:
-_(optional)_
-Provide the TicketID, where the bug report initiated.
-
 ### Environment
 
 * **Kendo UI version:** 202x.r.ddd
 * **jQuery version:** x.y
-* **Browser:** [all | Chrome XX | Firefox XX | Edge XX | Safari XX | Mobile Chrome XX | Android X.X Web Browser | iOS XX Safari | iOS XX UIWebView | iOS XX WKWebView ]
+* **Browser:** [all | Chrome XX | Firefox XX | IE XX | Safari XX | Mobile Chrome XX | Android X.X Web Browser | iOS XX Safari | iOS XX UIWebView | iOS XX WKWebView ] 
+
+

.github/ISSUE_TEMPLATE/config.yml

@@ -121,15 +121,27 @@ navigation:
      "installation":
         title: "Installation & Upgrade"
         position: 4
-     "installation-mvc":
-        title: "Installation"
-        position: 4
      "installation/system-requirements":
         title: "System Requirements"
         position: 1
+     "installation/installation-options":
+        title: "Instalation Options"
+        position: 2
+     "installation/activating-your-license":
+        title: "Activating Your License"
+        position: 3
+     "installation-mvc":
+        title: "Installation"
+        position: 4
      "installation-mvc/system-requirements":
         title: "System Requirements"
         position: 1
+     "installation-mvc/installation-options":
+        title: "Instalation Options"
+        position: 2
+     "installation-mvc/activating-your-license":
+        title: "Activating Your License"
+        position: 3
      "installation/adding-client-side-resources":
          title: "Providing Client-Side Resources"
          position: 6
@@ -246,6 +258,9 @@ navigation:
      "tutorials/tutorial-saleshub/order-page":
         title: "Order Page"
         position: 3
+     "licensing":
+        title: "Licensing"
+        position: 59
      "troubleshoot":
         title: "Troubleshooting"
         position: 60

docs-aspnet/_config.yml

@@ -0,0 +1,37 @@
+#license-key-version
+
+>tip Starting with {{ site.product }} version 2025.1.212, you must activate the UI components by providing a license key file. Previous versions do not require a license key.
+
+#end
+
+#license-key-update-whenever
+
+>tip Update your license key [whenever you renew or purchase a new Telerik license]({%slug installation_license_key_aspnetcore%}#license-key-updates).
+
+#end
+
+#license-key-manual-steps
+
+To download and install your Telerik license key:
+
+1. Go to the <a href="https://www.telerik.com/account/your-licenses/license-keys" target="_blank">License Keys page</a> in your Telerik account.
+1. Click the **Download License Key** button.
+1. Save the `telerik-license.txt` file to:
+    * (on Windows) `%AppData%\Telerik\telerik-license.txt`, for example, `C:\Users\...\AppData\Roaming\Telerik\telerik-license.txt`
+    * (on Mac or Linux) `~/.telerik/telerik-license.txt`, for example, `/Users/.../.telerik/telerik-license.txt`
+
+This will make the license key available to all Telerik .NET apps that you develop on your local machine.
+
+#end
+
+#license-key-know-more-link
+
+The [Telerik License Key]({%slug installation_license_key_aspnetcore%}) article provides additional details on installing and updating your Telerik license key in different scenarios. [Automatic license key maintenance]({%slug installation_license_key_aspnetcore%}#automatic-installation) is more effective and recommended in the long run.
+
+#end
+
+#ci-cd-support
+
+> The deployment articles in this documentation provide general guidance and fundamentals. Telerik does not provide technical support for setting up CI/CD environments or application publishing infrastructure, except for questions about [using Telerik license keys]({%slug deployment_license_key_aspnetcore%}).
+
+#end

docs-aspnet/_contentTemplates/licensing-templates.md

@@ -0,0 +1,64 @@
+---
+title: Setting Up Your License Key in CI/CD
+page_title: Setting Up Your License Key in CI/CD
+description: Learn how to create and install a Telerik license key file in continuous integration and continuous delivery (CI/CD) workflows and environments.
+slug: deployment_license_key_aspnetcore
+position: 11
+---
+
+# Setting Up Your License Key in CI/CD Environment
+
+This article describes how to set up and activate your [{{ site.product }} license key]({%slug installation_license_key_aspnetcore%}) across a few popular CI/CD services by using environment variables.
+
+@[template](/_contentTemplates/licensing-templates.md#ci-cd-support)
+
+## Basics
+
+When working with CI/CD platforms, always add the [`Telerik.Licensing` NuGet package]({%slug installation_license_key_aspnetcore%}#list-of-provided-packages) as a project dependency. This package activates the {{ site.product_short }} components at build time by using the provided license key.
+
+The license activation process in a CI/CD environment involves the following steps:
+
+1. Add the `Telerik.Licensing` NuGet package as a dependency to all projects that reference {{ site.product }} or Telerik Document Processing:
+    ```
+    <PackageReference Include="Telerik.Licensing" Version="1.*" />
+    ```
+1. Go to the <a href="https://www.telerik.com/account/your-licenses/license-keys" target="_blank">License Keys page</a> in your Telerik account and get your license key.
+1. Set your license key value as an environment variable with a name `TELERIK_LICENSE`.
+
+## Creating Environment Variables
+
+The recommended way to provide your license key to the `Telerik.Licensing` NuGet package in CI/CD environment is to use environment variables. Each CI/CD platform has a different process for setting environment variables. This article lists only some of the most popular examples.
+
+### Azure Pipelines (YAML)
+
+1. Create a new <a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=yaml%2Cbatch" target="_blank">user-defined variable</a> named `TELERIK_LICENSE`.
+1. Paste the contents of the license key file as a value.
+
+### Azure Pipelines (Classic)
+
+1. Create a new <a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=classic%2Cbatch" target="_blank">user-defined variable</a> named `TELERIK_LICENSE`.
+1. Paste the contents of the license key file as a value.
+
+### GitHub Actions
+
+1. Create a new <a href="https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository" target="_blank">Repository Secret</a> or an <a href="https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization" target="_blank">Organization Secret</a>.
+1. Set the name of the secret to `TELERIK_LICENSE` and paste the contents of the license file as a value.
+1. After running `npm install` or `yarn`, add a build step to activate the license:
+    ```
+    env:
+        TELERIK_LICENSE: ${ { secrets.TELERIK_LICENSE } } # remove the spaces between the brackets
+    ```
+
+## Next Steps
+
+* [Restore Telerik NuGet Packages in CI/CD Workflows]({%slug nuget_keys%})
+
+## See Also
+
+* [Licensing FAQ]({%slug licensing-faq%})
+* [CI, CD, Build Server]({%slug deployment_ci_cd_build%})
+{% if site.core %}
+* [Getting Started with {{ site.product }}]({%slug gettingstarted_aspnetmvc6_aspnetmvc%})
+{% else %}
+* [Getting Started with {{ site.product }}]({%slug setupwithnuget_aspnetmvc%})
+{% endif %}

docs-aspnet/deployment/ci-cd-license-key.md

@@ -28,6 +28,12 @@ You can read more about deploying {{ site.framework }} applications in MSDN - ma
 * [Host and deploy ASP.NET MVC](https://learn.microsoft.com/en-us/aspnet/mvc/overview/deployment/)
 {% endif %}
 
+@[template](/_contentTemplates/licensing-templates.md#ci-cd-support)
+
+## License Key
+
+Before building a {{ site.framework }} app in a CI/CD environment, [set up a Telerik license key in CI/CD]({%slug deployment_license_key_aspnetcore%}). The process is different than in a [local development environment]({%slug installation_license_key_aspnetcore%}).
+
 ## Telerik Components
 
 The {{ site.product }} components consist of:

docs-aspnet/deployment/overview.md

@@ -11,7 +11,7 @@ position: 20
 This page provides information for common issues you may encounter while deploying applications with the {{ site.product_short }} components.
 
 
->important The machine that performs the publish build must be able to properly restore the referenced Telerik NuGet packages. See the [CI, CD, Build Server]({%slug deployment_ci_cd_build%}) article for more details on setting automation up.
+>important The machine that performs the publish build must be able to properly restore the referenced Telerik NuGet packages. For guidelines on how to use our online feed, refer to [Setting Up the Telerik NuGet Feed]({%slug nuget_install_aspnetmvc6_aspnetmvc%}#setting-up-the-telerik-nuget-feed). See the [CI, CD, Build Server]({%slug deployment_ci_cd_build%}) article for more details on setting automation up.
 
 
 ### Trial Message

docs-aspnet/deployment/troubleshooting.md

@@ -2,7 +2,7 @@
 title: Build the Team Efficiency Dashboard Project - Step 1 Getting Up and Running
 page_title: Build the Team Efficiency Dashboard Project - Getting Up and Running
 description: "Build the Team Efficiency Dashboard Project - Step 1: Getting Up and Running."
-previous_url: /tutorials/quickstart/team-efficiency, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter1, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter2, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter3, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter4, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter5, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter6, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter7, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter8, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter9, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter10
+previous_url: /tutorials/quickstart/team-efficiency/getting-up-and-running, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter1, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter2, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter3, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter4, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter5, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter6, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter7, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter8, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter9, /tutorials/tutorial-aspnetmvc-quick-start/build-team-efficiency-app/chapter10
 slug: gettingupandrunning_timeefficiencyapp_aspnetmvc6
 position: 1
 ---
@@ -110,4 +110,4 @@ At this point, you have the wire frame for a basic MVC application. Next, you wi
 
 > Because the **Convert to Telerik application**, **Upgrade Project**, or **Configure Project** wizards modify the `_Layout.cshtml` file, make sure you check the position of the custom CSS declarations afterwards.
 
-Now that your app is ready for development. Let's add some simple input components to create a nice user experience.
+Now that your app is ready for development. Let's add some simple input components to create a nice user experience.

docs-aspnet/html-helpers/helper-basics/build-team-efficiency-dashboard/getting-up-and-running.md

@@ -0,0 +1,78 @@
+---
+title: License Key Errors
+page_title: Telerik License Key Errors
+description: Troubleshooting Telerik license key errors when using {{ site.product }}.
+slug: troubleshooting-license-key-errors
+tags: license, key, error, troubleshooting
+position: 1
+---
+
+# License Key Errors
+
+This page provides solutions for license key errors that you may encounter while building {{ site.product_short }} apps.
+
+@[template](/_contentTemplates/licensing-templates.md#ci-cd-support)
+
+## Basics
+
+A Telerik license key error may occur in the following scenarios:
+
+* Missing license key.
+* Using an expired subscription license after the end of the subscription term.
+* Using a perpetual license with a product version that was released outside the validity period of your license.
+* Using an expired trial license.
+* Using an outdated license key after making renewals or purchases.
+* Using a license key that doesn't include {{ site.product }}.
+* Using conflicting license keys in the same environment. For example, using one global license key and one in the app. Or, using a license key file together with an environment variable in CI/CD environment.
+
+Refer to the error messages below for specific tips.
+
+## Error Messages
+
+* [No license key is detected](#no-license-key-is-detected)
+* [Invalid license key](#invalid-license-key)
+* [Your subscription license has expired](#your-subscription-license-has-expired)
+* [Your perpetual license is invalid](#your-perpetual-license-is-invalid)
+* [Your trial license has expired](#your-trial-license-has-expired)
+* [Your license is not valid for the detected product(s)](#your-license-is-not-valid-for-the-detected-products)
+
+### No license key is detected
+
+[Install a license key file]({%slug installation_license_key_aspnetcore%}). If you already downloaded it, make sure it's [saved at the right place]({%slug installation_license_key_aspnetcore%}#manual-installation).
+
+### Invalid license key
+
+Follow the [automatic]({%slug installation_license_key_aspnetcore%}#automatic-installation) or [manual]({%slug installation_license_key_aspnetcore%}#manual-installation) installation steps from scratch.
+
+### Your subscription license has expired
+
+<a href="https://www.telerik.com/account/your-licenses" target="_blank">Renew your subscribtion</a>. Then, [update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates).
+
+### Your perpetual license is invalid
+
+You are using a product version released outside the validity period of your perpetual license. To remove the error message, do either of the following:
+
+* <a href="https://www.telerik.com/account/your-licenses" target="_blank">Renew your subscribtion</a>. Then, [update your license key](slug://installation-license-key#license-key-updates).
+* Downgrade your app to a {{ site.product }} version that was released within the subscription period of your perpetual license.
+
+### Your trial license has expired
+
+{% if site.core %}
+<a href="https://www.telerik.com/purchase/aspnet-core-ui" target="_blank">Purchase a commercial license to continue using {{ site.product }}</a>.
+{% else %}
+<a href="https://www.telerik.com/purchase/aspnet-mvc" target="_blank">Purchase a commercial license to continue using {{ site.product }}</a>.
+{% endif %}
+
+### Your license is not valid for the detected product(s)
+
+{% if site.core %}
+<a href="https://www.telerik.com/purchase/aspnet-core-ui" target="_blank">Review the purchase options for {{ site.product }}</a>. Then, [update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates).
+{% else %}
+<a href="https://www.telerik.com/purchase/aspnet-mvc" target="_blank">Review the purchase options for {{ site.product }}</a>. Then, [update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates).
+{% endif %}
+
+## See Also
+
+* [Download and Install License Key]({%slug installation_license_key_aspnetcore%})
+* [Licensing FAQ]({%slug licensing-faq%})
+* [Use License Keys in CI/CD]({%slug deployment_license_key_aspnetcore%})