Licensing updates continued

Author: dimodi

_contentTemplates/common/general-info.md

@@ -131,5 +131,5 @@ Visit [status.telerik.com](https://status.telerik.com) to check the status of th
 
 
 #ci-cd-support
-> All 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.
+> 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).
 #end

_contentTemplates/common/get-started.md

@@ -13,7 +13,7 @@
 
 ## Step 0: Download Telerik UI for Blazor
 
-* If you have already purchased a Telerik UI for Blazor license, continue with the [next step and create a new project](#step-1-create-a-new-project).
+* If you have already purchased a Telerik UI for Blazor license, continue with the [next step and create a new project](#step-2-create-a-new-project).
 
 * If you are new to UI for Blazor and haven't purchased a license yet, you must <a href="https://www.telerik.com/download-trial-file/v2-b/ui-for-blazor" target="_blank">download and install the trial version</a> of the UI for Blazor components&mdash;this will activate your free trial and allow you to use the components. During the installation, select the **Set up Telerik NuGet package source** checkbox and the installer will configure the Telerik [online NuGet feed](slug://installation/nuget) automatically. You will use this feed later in the tutorial. 
 
@@ -23,7 +23,7 @@
 
 
 #add-nuget-feed
-## Step 2: Add the Telerik NuGet Feed to Visual Studio
+## Step 3: Add the Telerik NuGet Feed to Visual Studio
 
 In this tutorial, you will use the [Telerik NuGet feed](slug://installation/nuget) to download the UI for Blazor components. This NuGet feed is private and requires you to authenticate with your Telerik user name and password:
 
@@ -182,6 +182,32 @@ You can learn more about the [`TelerikRootComponent` purpose and usage](slug://r
 
 #license-key-version
 
->tip This article applies to Telerik UI for Blazor version **7.2.0** and above. Older versions do not require a license key.
+>tip This documentation section applies to Telerik UI for Blazor version **7.2.0** and above. Older 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#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-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) article provides additional details on installing and updating your Telerik license key in different scenarios.
 
 #end

deployment/ci-cd-build-server.md

@@ -12,7 +12,7 @@ position: 5
 
 This article explains some concepts and how to troubleshoot the most common errors related to setting up the Telerik NuGet packages for automated builds, CI and CD.
 
-> Telerik license keys are outside the scope of this article. Refer to article [Telerik License Key in CI/CD](slug://deployment-license-key)
+> To successfully set up a CI/CD environment for Telerik Blazor apps, also refer to the article about [Telerik license keys in CI/CD](slug://deployment-license-key).
 
 Sections in this article:
 

getting-started/client-blazor.md

@@ -21,11 +21,19 @@ This article explains how to get the <a href = "https://www.telerik.com/blazor-u
 
 @[template](/_contentTemplates/common/get-started.md#prerequisites-tip)
 
-## Blazor Client Prerequisites
+## Prerequisites
 
 @[template](/_contentTemplates/common/get-started.md#prerequisites-download)
 
-## Step 1: Create a New Project
+## Step 1: Install a License Key
+
+@[template](/_contentTemplates/common/get-started.md#license-key-version)
+
+@[template](/_contentTemplates/common/get-started.md#license-key-manual-steps)
+
+@[template](/_contentTemplates/common/get-started.md#license-key-know-more-link)
+
+## Step 2: Create a New Project
 
 1. Open Visual Studio and select **Create a new project**.
 
@@ -35,24 +43,24 @@ This article explains how to get the <a href = "https://www.telerik.com/blazor-u
 
 @[template](/_contentTemplates/common/get-started.md#add-nuget-feed)
 
-## Step 3: Install the Telerik UI for Blazor Components
+## Step 4: Install the Telerik UI for Blazor Components
 
 1. Right-click the `.Client` project in the solution and select **Manage NuGet Packages**.
 
    ![Manage NuGet Packages](images/manage-nuget-packages-for-client-app.png)
 
 2. Install the Telerik Blazor NuGet package:
 
-   1. Select the `telerik.com` **Package source** that you [added earlier](#step-2-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate with your [Telerik account](https://www.telerik.com/account/) user name and password.
+   1. Select the `telerik.com` **Package source** that you [added earlier](#step-3-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate with your [Telerik account](https://www.telerik.com/account/) user name and password.
    1. Select the **Browse** tab, find the NuGet package, and click **Install**. Commercial license holders should install `Telerik.UI.for.Blazor`. Trial users should install `Telerik.UI.for.Blazor.Trial`.
 
    ![Add Telerik Blazor Package to Client Project](images/add-telerik-nuget-to-client-app.png)
 
-## Step 4: Enable the Blazor UI Components
+## Step 5: Enable the Blazor UI Components
 
 To enable the Telerik UI for Blazor components, you must add several client-side dependencies to the application, include the required `@using` statements, add the `TelerikRootComponent` component, and register the Telerik Blazor service.
 
-### 4.1. Add the Telerik UI for Blazor Client Assets
+### 5.1. Add the Telerik UI for Blazor Client Assets
 
 1\. Add the `telerik-blazor.js` file to your main index file&mdash;`wwwroot/index.html`.
 
@@ -63,7 +71,7 @@ To enable the Telerik UI for Blazor components, you must add several client-side
 
 @[template](/_contentTemplates/common/js-interop-file.md#theme-static-asset-snippet)
 
-### 4.2. Include @using Statements
+### 5.2. Include @using Statements
 
 In the `~/_Imports.razor` file, add the `@using` directives below. This configures the project to recognize the Telerik components in all files. You can register one or both icon namespaces, depending on the [icon type you will be using](slug://common-features-icons).
 
@@ -74,13 +82,13 @@ In the `~/_Imports.razor` file, add the `@using` directives below. This configur
 @using Telerik.FontIcons
 ````
 
-### 4.3. Add the TelerikRootComponent
+### 5.3. Add the TelerikRootComponent
 
 Use a single `TelerikRootComponent` component as a top-level component in the Blazor client-side app.
 
 @[template](/_contentTemplates/common/get-started.md#root-component-main-layout)
 
-### 4.4. Register the Telerik Blazor Service
+### 5.4. Register the Telerik Blazor Service
 
 In the `~/Program.cs` file of the client web application, register the Telerik Blazor service.
 
@@ -89,7 +97,7 @@ In the `~/Program.cs` file of the client web application, register the Telerik B
 
 Now your project can use the Telerik UI for Blazor components.
 
-## Step 5: Add a Component to a View
+## Step 6: Add a Component to a View
 
 The final step in this tutorial is to use a Telerik UI for Blazor component in a view and run it in the browser.
 

getting-started/hybrid-blazor.md

@@ -28,19 +28,23 @@ Before adding the Telerik UI for Blazor components, ensure that the correspondin
 
 ## Adding the UI for Blazor Components
 
-The process for adding Telerik UI for Blazor to a WinForms, WPF, or MAUI app is similar to including the components in a [native Blazor app](slug://getting-started/what-you-need) and involves the six steps listed below. 
+The process for adding Telerik UI for Blazor to a WinForms, WPF, or MAUI app is similar to including the components in a [native Blazor app](slug://getting-started/what-you-need) and involves the steps listed below. 
 
 ### 1. Get the Telerik UI for Blazor Package
 
 To use the  UI for Blazor components, install the `Telerik.UI.for.Blazor` package and include its reference in the `.csproj` file of the app. [Read more on where to get the `Telerik.UI.for.Blazor` package...](slug://getting-started/what-you-need#nuget-packages)
 
-### 2. Add the Telerik Client Assets
+### 2. Install the Telerik License Key
+
+[Install your Telerik license key](slug://getting-started/what-you-need#license-key) to activate Telerik UI for Blazor during application build.
+
+### 3. Add the Telerik Client Assets
 
 To have the Telerik Blazor components look and behave as expected, you need the Telerik [CSS and JavaScript assets](slug://getting-started/what-you-need#css-theme-and-javascript-files). Include the assets inside the `<head>` of the `wwwroot/index.html` file.
 
 You can add the Telerik resources as [static assets](slug://getting-started/what-you-need#css-theme-and-javascript-files).
 
-### 3. Include @using Statements 
+### 4. Include @using Statements 
 
 You can set the project to recognize all Telerik components without explicit `@using` statements in every `.razor` file. To achieve this, add the code below to your `~/_Imports.razor` file. You can register one or both icon namespaces depending on the [icon type you will be using](slug://common-features-icons).
 
@@ -55,7 +59,7 @@ You can set the project to recognize all Telerik components without explicit `@u
 @using Telerik.FontIcons
 ````
 
-### 4. Add the TelerikRootComponent
+### 5. Add the TelerikRootComponent
 
 Use a single [`TelerikRootComponent`](slug://rootcomponent-overview) component as a top-level component in the app and make sure it wraps all content. At the time of writing, custom layouts are not supported, so you can add it to:
 
@@ -66,7 +70,7 @@ Make sure that the `TelerikRootComponent` matches the web view viewport and remo
 
 Once custom layouts are supported, you will be able to configure a Telerik layout in the same way as with regular Blazor web apps (check [Common Configuration](slug://getting-started/what-you-need#telerikrootcomponent)).
 
-### 5. Register the Telerik Services
+### 6. Register the Telerik Services
 
 The next step is to register the Telerik services. Add the Telerik services in accordance to the practice your native app requires.
 
@@ -106,7 +110,7 @@ namespace MyBlazorMauiAppName
 }
 ````
 
-### 5. Add the UI for Blazor Components
+### 7. Add the UI for Blazor Components
 
 Add your desired Telerik Blazor components in the app as in a native Blazor app. Explore the available UI for Blazor components and their features in our [live demos](https://demos.telerik.com/blazor-ui).
 

getting-started/server-blazor.md

@@ -20,7 +20,15 @@ This article explains how to get the Telerik UI for Blazor components in your .N
 
 @[template](/_contentTemplates/common/get-started.md#prerequisites-download)
 
-## Step 1: Create a New Project
+## Step 1: Install a License Key
+
+@[template](/_contentTemplates/common/get-started.md#license-key-version)
+
+@[template](/_contentTemplates/common/get-started.md#license-key-manual-steps)
+
+@[template](/_contentTemplates/common/get-started.md#license-key-know-more-link)
+
+## Step 2: Create a New Project
 
 1. Open Visual Studio and select **Create a new project**.
 
@@ -30,24 +38,24 @@ This article explains how to get the Telerik UI for Blazor components in your .N
 
 @[template](/_contentTemplates/common/get-started.md#add-nuget-feed)
 
-## Step 3: Install the Telerik UI for Blazor Components
+## Step 4: Install the Telerik UI for Blazor Components
 
 1. Right-click  the Blazor Server project in the solution and select **Manage NuGet Packages**.
 
 ![Manage NuGet Packages](images/manage-nuget-packages-for-server-app.png)
 
 2. Install the Telerik Blazor NuGet package:
 
-   1. Select the `telerik.com` **Package source** that you [added earlier](#step-2-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate with your [Telerik account](https://www.telerik.com/account/) user name and password.
+   1. Select the `telerik.com` **Package source** that you [added earlier](#step-3-add-the-telerik-nuget-feed-to-visual-studio). As this is a private NuGet feed, you must authenticate with your [Telerik account](https://www.telerik.com/account/) user name and password.
    1. Select the **Browse** tab, find the NuGet package, and click **Install**. Commercial license holders should install `Telerik.UI.for.Blazor`. Trial users should install `Telerik.UI.for.Blazor.Trial`.
 
 ![Add Telerik Blazor Package to the project](images/add-telerik-nuget-to-server-app.png)
 
-## Step 4: Enable the Blazor UI Components
+## Step 5: Enable the Blazor UI Components
 
 To enable the Telerik UI for Blazor components, you must add several client-side dependencies to the application, include the required `@using` statements, add the `TelerikRootComponent` component, and register the Telerik Blazor service.
 
-### 4.1. Add the Telerik UI for Blazor Client Assets
+### 5.1. Add the Telerik UI for Blazor Client Assets
 
 1\. Add the `telerik-blazor.js` file to the `<head>` of your main index file:
 
@@ -65,7 +73,7 @@ To enable the Telerik UI for Blazor components, you must add several client-side
 
 @[template](/_contentTemplates/common/js-interop-file.md#theme-static-asset-snippet)
 
-### 4.2. Include @using Statements
+### 5.2. Include @using Statements
 
 In the `~/_Imports.razor` file, add the `@using` directives below. This configures the project to recognize the Telerik components in all files. You can register one or both icon namespaces, depending on the [icon type you will be using](slug://common-features-icons).
 
@@ -76,13 +84,13 @@ In the `~/_Imports.razor` file, add the `@using` directives below. This configur
 @using Telerik.FontIcons
 ````
 
-### 4.3. Add the TelerikRootComponent
+### 5.3. Add the TelerikRootComponent
 
 Use a single [`TelerikRootComponent`](slug://rootcomponent-overview) component as a top-level component in the app.
 
 @[template](/_contentTemplates/common/get-started.md#root-component-main-layout)
 
-### 4.4. Register the Telerik Blazor Service
+### 5.4. Register the Telerik Blazor Service
 
 In the `Program.cs` file of your Blazor Server project, register the Telerik Blazor Service:
 
@@ -91,7 +99,7 @@ In the `Program.cs` file of your Blazor Server project, register the Telerik Bla
 
 Now your Blazor Server project can use the Telerik UI for Blazor components.
 
-## Step 5: Add a Component to a View
+## Step 6: Add a Component to a View
 
 The final step in this tutorial is to use a Telerik UI for Blazor component in a view and run it in the browser.
 

getting-started/vs-integration/convert-project-wizard.md

@@ -84,6 +84,10 @@ In this step, you can apply one of the available [themes](slug://themes-overview
 
 You can choose to back up the project state before the conversion (in a folder called `<ProjectName>_Backup>_<timestamp>`).
 
+### Step 4: Install or Update License Key
+
+If necessary, the Telerik Visual Studio extension will notify you about a missing or outdated [license key](slug://installation-license-key), and will help you resolve the issue.
+
 ## Troubleshooting
 
 When converting a project, you may encounter the following most common issues:

getting-started/vs-integration/introduction.md

@@ -14,17 +14,19 @@ To integrate with Visual Studio (VS), Telerik UI for Blazor provides VS extensio
 {% include cta-panel-introduction.html %}
 {% endif %}
 
-The Telerik UI for Blazor extensions provide the following advantages:
+The Telerik UI for Blazor extension for Visual Studio provides the following advantages:
 
-* They facilitate the [creation of projects](slug://getting-started-vs-integration-new-project) and enable you to create a pre-configured project from a template. In this way, you can start using the Telerik UI for Blazor components immediately without additional project setup.
+* It facilitates the [creation of pre-configured projects](slug://getting-started-vs-integration-new-project) from a template. In this way, you can start using the Telerik UI for Blazor components immediately without additional project setup.
 
-* They allow you to [add the Telerik UI components to an existing project](slug://getting-started-vs-integration-convert-project) with a few clicks.
+* It allows you to [add the Telerik UI components to an existing project](slug://getting-started-vs-integration-convert-project) with a few clicks.
 
-* They notify you about [new component versions](slug://getting-started-vs-integration-latest-version ).
+* It notifies you about [new component versions](slug://getting-started-vs-integration-latest-version ).
 
-The Telerik UI for Blazor VS extensions support Visual Studio 2022 and 2019. @[template](/_contentTemplates/common/general-info.md#vsx-download)
+* It enables you to easily install or update your [Telerik license key](slug://installation-license-key).
 
-To access the VS extensions, go to the **Extensions** > **Telerik** > **Telerik UI for Blazor** menu.
+The Telerik UI for Blazor VS extension supports Visual Studio 2022 and 2019. @[template](/_contentTemplates/common/general-info.md#vsx-download)
+
+To access the Telerik Visual Studio extension, go to the **Extensions** > **Telerik** > **Telerik UI for Blazor** menu.
 
 ![Telerik UI for Blazor Visual Studio Extensions window](images/open-vs-extensions.png)
 

getting-started/vs-integration/new-project-wizard.md

@@ -85,6 +85,10 @@ The **Create New Project** wizard generates a project that is based on the Micro
 
 Finally, you can apply one of the available [themes](slug://themes-overview) to your project.
 
+### Step 4: Install or Update License Key
+
+If necessary, the Telerik Visual Studio extension will notify you about a missing or outdated [license key](slug://installation-license-key), and will help you resolve the issue.
+
 ## See Also
 
 * [Telerik UI for Blazor Visual Studio Extensions Overview](slug://getting-started-vs-integration-overview)