docs(licensing): refactor and move new licensing files to a new location

Author: attilaantal

getting-started/activating-your-license/license-key-errors.md

@@ -0,0 +1,48 @@
+---
+title: Adding Your License Key to CI Services
+page_title: Adding Your License Key to CI Services
+description: Learn how to activate the Telerik UI for ASP.NET AJAX components by downloading and setting up your Telerik components license key for use in CI/CD environments.
+slug: licensing/add-license-to-ci-cd
+tags: telerik,webforms,components,license,activate,download,ci,cd,environment
+position: 2
+---
+
+# Adding Your License Key to CI/CD Services
+
+This article describes how to set up and activate your Telerik UI for ASP.NET AJAX [license key]({%slug licensing/license-key%}) across a few popular CI/CD services by using environment variables.
+
+When working with CI/CD platforms, always add the `Telerik.Licensing` NuGet package as a project dependency. This package activates the Telerik UI for ASP.NET AJAX components at build time by using the provided license key.
+
+> If you cannot use NuGet packages in your project, see the workaround in the [Adding Your License Key to CI Platforms as a Code Snippet]({%slug licensing-add-license-as-snippet-ci-cd%}) KB article.
+The license activation process in a CI/CD environment involves the following steps:
+
+1. [Download]({%slug licensing/license-key%}) a license key from your Telerik account.
+
+1. Add the `Telerik.Licensing` NuGet package as a project dependency.
+
+    ```
+    <PackageReference Include="Telerik.Licensing" Version="1.*" />
+    ```
+1. [Create an environment variable](#creating-an-environment-variable) named `TELERIK_LICENSE` and add your Telerik UI for ASP.NET AJAX license key as a value.
+## Creating an Environment Variable
+The recommended approach for providing your license key to the `Telerik.Licensing` NuGet package is to use environment variables. Each CI/CD platform has a different process for setting environment variables and this article lists only some of the most popular examples.
+### Azure Pipelines (YAML)
+1. Create a new [user-defined variable](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=yaml%2Cbatch) named `TELERIK_LICENSE`.
+1. Paste the contents of the license key file as a value.
+### Azure Pipelines (Classic)
+1. Create a new [user-defined variable](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=classic%2Cbatch) named `TELERIK_LICENSE`.
+1. Paste the contents of the license key file as a value.
+### GitHub Actions
+1. Create a new [Repository Secret](https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository) or an [Organization Secret](https://docs.github.com/en/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-an-organization).
+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:
+```YAML
+env:
+    TELERIK_LICENSE: ${{ secrets.TELERIK_LICENSE }}
+```
+
+## See Also
+
+* [Setting Up Your License Key]({%slug licensing/license-key%})
+* [License Activation Errors and Warnings]({%slug licensing/license-errors-warnings%})
+* [Frequently Asked Questions about Your Telerik UI forASP.NET AJAX License Key]({%slug licensing/licensing-faq%})

getting-started/activating-your-license/setting-up-your-license.md

@@ -0,0 +1,45 @@
+---
+title: License Activation Errors and Warnings
+page_title: Telerik License Activation Errors and Warnings
+description: Troubleshooting Telerik license key errors when using UI for ASP.NET AJAX.
+slug: licensing/license-errors-warnings
+tags: license, key, error, warning, troubleshooting
+position: 4
+---
+
+# License Activation Errors and Warnings
+
+Starting with the 2025 Q1 release, using Telerik UI for ASP.NET AJAX without a license or with an invalid license causes specific license warnings and errors. This article defines what an invalid license is, explains what is causing it, and describes the related license warnings and errors.
+
+## Invalid License
+
+An invalid license can be caused by any of the following:
+
+* Using an expired subscription license—subscription licenses expire at the end of the subscription term.
+* Using a perpetual license for product versions released outside the validity period of your license.
+* Using an expired trial license.
+* A missing license for Telerik UI for ASP.NET AJAX.
+* Not installing a license key in your application.
+* Not updating the license key after renewing your Telerik UI for ASP.NET AJAX license.
+
+## License Warnings and Errors
+
+When using Telerik UI for ASP.NET AJAX in a project with an expired or missing license, the `Telerik.Licensing` build task will indicate the following errors:
+
+
+| Error or Condition |	Solution |
+| --- | --- |
+| `No license key is detected` |	[Set up a license key]({%slug licensing/license-key%}) to activate the UI controls and remove the error message. |
+| `Invalid license key` |	[Download a new license key]({%slug licensing/license-key%}#downloading-the-license-key) and use it to activate the UI controls and remove the error message. |
+| `Your subscription license has expired.` |	Renew your subscription and [download a new license key]({%slug licensing/license-key%}#downloading-the-license-key). |
+| `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: |
+| | - Renew your license, then download a new license key and use it to activate the controls. |
+| | - Downgrade to a product version included in your perpetual license as indicated in the message. |
+| `Your trial license has expired.` |	Purchase a commercial license to continue using the product. |
+| `Your license is not valid for the detected product(s).` |	Review the purchase options for the listed products. Alternatively, remove the references to the listed packages from `package.json`. |
+
+## See Also
+
+* [Setting Up Your License Key]({%slug licensing/license-key%})
+* [Adding the License Key to CI Services]({%slug licensing/add-license-to-ci-cd%})
+* [Frequently Asked Questions about Your Telerik UI for ASP.NET AJAX License Key]({%slug licensing/licensing-faq%})

licensing/add-license-to-ci-cd.md

@@ -0,0 +1,60 @@
+---
+title: Setting Up Your License Key
+page_title: Setting Up Your License Key File
+description: Learn how to install a Telerik license key file, which is required during application building and deployment.
+slug: licensing/license-key
+tags: installation, license, key
+position: 1
+---
+
+# Setting Up Your Telerik UI for ASP.NET AJAX License Key
+
+>Starting with the **2025 Q1** release, the UI components from the Telerik UI for ASP.NET AJAX library require activation through a license key (trial or commercial). 
+
+This article describes how to download your personal license key and use it to activate the Telerik UI for ASP.NET AJAX components.
+
+A missing or invalid license results in [errors and warnings]({%slug licensing/license-errors-warnings%}) during build and run-time indicators such as watermarks and banners.
+
+## Downloading the License Key
+
+>warning The license key file is personal and confidential. Do not commit this file to source control and do not save it to a publicly accessible location!
+
+To download a license key for Telerik UI for ASP.NET AJAX, you must have either a developer license or a trial license. If you are new to Telerik UI for ASP.NET AJAX, [sign up for a free trial](https://www.telerik.com/aspnet-ajax) first, and then follow the steps below:
+
+1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys?_gl=1*cgbz4c*_gcl_au*MTIyNTMyNzI1My4xNzMyMDI2NzU3*_ga*MjAyMTI5MTQ4MS4xNzMyMDI2NzU1*_ga_9JSNBCSF54*MTczOTM0ODI2NS4xNi4xLjE3MzkzNTkxMTcuNTMuMC4w) page in your Telerik account.
+2. Click the **Download License Key** button.
+   !["Download License Key"](images/download-license-key.png "Download License Key")
+3. Next, [Activate your Telerik UI for ASP.NET AJAX components](#activating-the-telerik-ui-for-asp-net-ajax-components).
+
+The [Progress Control Panel](https://docs.telerik.com/controlpanel/introduction), [automated installers]({%slug getting-started/installation/installing-the-telerik-controls-from-msi-file%}), and the [Visual Studio Extensions]({%slug introduction/radcontrols-for-asp.net-ajax-fundamentals/integration-with-visual-studio/visual-studio-extensions/overview%}) will automatically download and store your license key in your home directory. This makes it available for all projects that you develop on your local machine.
+
+## Activating the Telerik UI for ASP.NET AJAX Components
+
+>important If your project doesn’t use NuGet packages, or you have a Web Site project, follow the instructions from the [Installing a License Key in Projects without NuGet References](#installing-a-license-key-in-projects-without-nuget-references) section.
+
+To activate the Telerik UI for ASP.NET AJAX controls:
+
+- Copy the downloaded `telerik-license.txt` license key file to your home directory. This makes the license key available to all projects that you develop on your computer:
+  - For Windows: `%AppData%\Telerik\telerik-icense.txt`
+  - For Mac/Linux: `~/.telerik/telerik-license.txt`
+  - Alternatively, copy the `telerik-license.txt` license key file to the root folder of your project. This makes the license key available only to this project. Do not commit the file to source control as this is your personal license key.
+
+When you build the project, the `Telerik.Licensing` NuGet package automatically locates the license file and uses it to activate the WebForms controls.
+
+## Installing a License Key in Projects without NuGet References
+
+Telerik strongly recommends the use of NuGet packages whenever possible. Only include the license key as a code snippet when NuGet packages are not an option.
+
+1. If you cannot use NuGet packages in your project, add the license as a code snippet:
+2. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
+3. On the Telerik UI for ASP.NET AJAX row, click the **View key** link in the **SCRIPT KEY** column.
+   !["Alt Text"](images/view-script-key.png "Alt Text")
+4. Copy the C# code snippet into a new file, for example, `TelerikLicense.cs`.
+5. Add the `TelerikLicense.cs` file to your project.
+   - In case of Web Site project, add the file to the `App_Code` folder.
+
+## See Also
+
+* [License Activation Errors and Warnings]({%slug licensing/license-errors-warnings%})
+* [Adding the License Key to CI Services]({%slug licensing/add-license-to-ci-cd%})
+* [Frequently Asked Questions about Your Telerik UI for ASP.NET AJAX License Key]({%slug licensing/licensing-faq%})