Merge pull request #1194 from telerik/didi/update-licensing

update license articles

Author: didiyordanova

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

@@ -1,13 +1,13 @@
 ---
-title: Adding Your License Key to CI Services
+title: Adding License Key to CI Services
 page_title: Adding Your License Key to CI Services
 description: Learn how to activate the Telerik UI for .NET MAUI components by downloading and setting up your Telerik components license key for use in CI/CD environments.
 slug: add-license-to-ci-cd
 tags: maui,components,license,activate,download,ci,cd,environment
 position: 2
 ---
 
-# Adding Your License Key to CI/CD Services
+# Adding the License Key to CI/CD Services
 
 This article describes how to set up and activate your Telerik UI for .NET MAUI [license key]({%slug set-up-your-license%}) across a few popular CI/CD services by using environment variables.
 

installation/licensing/images/telerik-vs-code-extension.png

@@ -7,7 +7,7 @@ tags: maui,components,license,activate,download,error,warning,questions,faq
 position: 3
 ---
 
-# Frequently Asked Questions about Your Telerik UI for .NET MAUI License
+# Frequently Asked Questions About Installing Telerik UI for .NET MAUI License Key
 
 This article lists the answers to the most frequently asked questions (FAQs) about working with the Telerik UI for .NET MAUI license key.
 

installation/licensing/images/vsx-download-license-key-file.png

@@ -1,47 +1,83 @@
 ---
-title: Setting Up Your License Key
+title: Installing Your License Key
 page_title: Setting Up Your License Key
 description: Learn how to activate the Telerik UI for .NET MAUI components by downloading and setting up your Telerik components license key.
 slug: set-up-your-license
 tags: maui,components,license,activate,download
 position: 1
 ---
 
-# Setting Up Your Telerik UI for .NET MAUI License Key
+# Installing Your Telerik UI for .NET MAUI License Key
 
 Starting with the Q1 2025 release, the UI components from the Telerik UI for .NET MAUI 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 .NET MAUI components.
 
 An invalid license results in [errors and warnings]({%slug license-errors-warnings%}) during build and run-time indicators such as watermarks and banners.
 
-## Downloading the License Key
-
 To download a license key for Telerik UI for .NET MAUI, you must have either a developer license or a trial license. If you are new to Telerik UI for .NET MAUI, sign up for a [free trial](https://www.telerik.com/try/ui-for-maui) first, and then follow the steps below.
 
-1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
+Depending on your development environment and preferences, you can install your license key in either of the following ways:
 
-1. Click the **Download License Key** button.
+* [Automatic Installation for projects with NuGet references](#automatic-license-key-installation)—Suitable for developers using Telerik productivity tools like the Telerik extensions for Visual Studio and the Progress Control Panel
+* [Manual installation for projects with NuGet references](#manual-license-key-installation)—Suitable for trial users and developers who prefer to manage their projects and Telerik product versions manually.
+* [Manual installation for projects using assembly references (no NuGet packages)](#adding-a-license-key-in-projects-without-nuget-references)—Suitable for developers who cannot use NuGet references in their projects and use the Telerik DLLs instead.
 
-    ![Download a Telerik UI for .NET MAUI License Key](./images/download-license-key.png)
+## Automatic License Key Installation
+
+Telerik provides tools that automatically provision your license key. These tools include the [Progress Control Panel]({%slug control-panel%}), the [Visual Studio Extensions]({%slug vs-integration-overview%}) and [Visual Studio Code extensions]({%slug getting-started-vs-code-integration-overview%}).
+
+### Installing a License Key with the VS Extensions
+
+To install your license key by using the [Telerik UI for .NET MAUI Visual Studio extensions]({%slug vs-integration-overview%}):
+
+1. Open Visual Studio.
+1. Go to **Extensions** > **Telerik** **Licensing** > **Download Key**.
+
+    ![.NET MAUI VS Extension License Key](./images/vsx-download-license-key-file.png)
+
+### Installing a License Key with the VS Code Extensions
+
+To install your license key by using the [Telerik UI for .NET MAUI Visual Studio Code extensions menu]({%slug getting-started-vs-code-integration-overview%}):
 
-The [Progress Control Panel]({%slug control-panel%}), [automated installers]({%slug automated-installer%}), and the [Visual Studio Extensions]({%slug vs-integration-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.
+1. Open Visual Studio Code
+1. Open the Visual Studio Code extensions menu:
+    * `Ctrl+Shift+P` on Windows/Linux
+    * `Cmd+Shift+P` on Mac.
 
-## Activating the Telerik UI for .NET MAUI Components
+1. Select **Telerik UI for .NET MAUI Template Wizard: Launch** from the menu and press **Enter**. 
+1. The **Telerik UI for .NET MAUI Template Wizard** opens.
+1. Check the **TELERIK ACCOUNT DETAILS** field in the wizard and press the **Download License Key File** button.
 
-To activate the Telerik UI for .NET MAUI controls:
+    ![.NET MAUI VS Extension License Key](./images/telerik-vs-code-extension.png)
+
+### Installing a License Key with the Progress Control Panel
+
+To install your Telerik License Key by using the [Progress Control Panel]({%slug control-panel%}), start the application. It automatically downloads your license key file `telerik-license.txt` to your home directory:
+
+* On Windows `%AppData%\Telerik` or `C:\Users\[windows_username]\%AppData%\Roaming\Telerik`.
+* On Mac/Linux: `~/.telerik/`.
+
+## Manual License Key Installation
+
+To manually download and install a license key for Telerik UI for .NET MAUI:
+
+1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
+
+1. Click the **Download License Key** button.
+
+    ![Download a Telerik UI for .NET MAUI License Key](./images/download-license-key.png)
 
-* Copy the [downloaded](#downloading-the-license-key) `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:
+1. Copy the [downloaded](#manual-license-key-installation) `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-license.txt`.
-        * For the standard Windows user, that path resolves to `C:\Users\[windows_username]\AppData\Roaming\Telerik\telerik-license.txt`, it can resolve differently for service accounts.
+    * For Windows: `%AppData%\Telerik\telerik-license.txt`. For the standard Windows user, that path resolves to `C:\Users\[windows_username]\AppData\Roaming\Telerik\telerik-license.txt`, it can resolve differently for service accounts.
     * For Mac/Linux: `~/.telerik/telerik-license.txt`. If `.telerik` folder does not exist, create such, and paste the `telerik-license.txt` file in it.
 
-* 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.
+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 MAUI controls.
 
-> If your project doesn’t use NuGet packages, see the [next document section](#installing-a-license-key-in-projects-without-nuget-references).
+> If your project doesn’t use NuGet packages, see the [next document section](#adding-a-license-key-in-projects-without-nuget-references).
 
-## Installing a License Key in Projects without NuGet References
+## Adding 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.
 
@@ -61,7 +97,7 @@ If you cannot use NuGet packages in your project, add the license as a code snip
 
 ## Updating Your License Key
 
-Whenever you purchase a new Telerik UI for .NET MAUI license or renew an existing one, always [download a new license key](#downloading-the-license-key). The new license key includes information about all previous license purchases. This process is referred to as a license key update. Once you have the new license key, use it to [activate the Telerik UI for .NET MAUI](#activating-the-telerik-ui-for-net-maui-components).
+Whenever you purchase a new Telerik UI for .NET MAUI license or renew an existing one, always [download a new license key](#manual-license-key-installation). The new license key includes information about all previous license purchases. This process is referred to as a license key update. Once you have the new license key, use it to [activate the Telerik UI for .NET MAUI](#activate-the-telerik-ui-for-net-maui-components).
 
 ## See Also