Skip to content

Commit bcce16a

Browse files
dimodidimodi
committed
Polish AI generated content
1 parent 569cf8f commit bcce16a

File tree

5 files changed

+84
-140
lines changed

5 files changed

+84
-140
lines changed

‎_contentTemplates/common/ai-coding-assistant.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,33 @@
11
#number-of-requests
22
A Telerik [Subscription license](https://www.telerik.com/purchase/faq/licensing-purchasing) is recommended in order to use the Telerik Blazor AI Coding Assistant without restrictions. Perpetual license holders and trial users can make a [limited number of requests per year](slug:ai-overview#number-of-requests).
33
#end
4+
5+
#vs-intro
6+
provides automated configuration commands for the Telerik AI-powered development tools. These commands help you quickly set up the [Telerik MCP server](slug:ai-mcp-server) and [GitHub Copilot extension](slug:ai-copilot-extension) for enhanced developer productivity with Telerik UI for Blazor components.
7+
#end
8+
9+
#prerequisites
10+
* Check the tool-specific prerequisites for the [Telerik Blazor MCP Server](slug:ai-mcp-server#prerequisites) and the [Telerik Blazor extension for GitHub Copilot](slug:ai-copilot-extension#prerequisites).
11+
#end
12+
13+
#verify-license-key
14+
file to verify that the `TELERIK_LICENSE_PATH` value matches your actual [Telerik license file location](slug:installation-license-key). Alternatively, replace `TELERIK_LICENSE_PATH` with `TELERIK_LICENSE` and set your license key directly. Using `TELERIK_LICENSE_PATH` is recommended.
15+
#end
16+
17+
#command-github-app
18+
command opens the [TelerikBlazor GitHub App installation page](https://github.com/apps/telerikblazor/installations/select_target) in your default browser. Then, follow the [installation instructions for the Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension#installation).
19+
#end
20+
21+
#copilot-instructions
22+
command generates a `copilot-instructions.md` file in the `.github` folder under the solution. This file contains custom instructions that help GitHub Copilot provide better assistance when working with Telerik UI for Blazor components. The generated file includes the following default instructions:
23+
24+
* Guidance to use the Telerik MCP Server whenever applicable
25+
* Guidance to prioritize the usage of Telerik UI components
26+
* Guidance to use best coding practices related to Telerik UI for Blazor
27+
#end
28+
29+
#see-also
30+
* [Telerik AI Tooling Overview](slug:ai-overview)
31+
* [Telerik Blazor MCP Server](slug:ai-mcp-server)
32+
* [Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension)
33+
#end

‎ai/copilot-extension.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ To use the Telerik GitHub Copilot extension for Blazor, you need to have:
2626

2727
To install the Telerik Blazor Copilot extension:
2828

29-
1. Go to the [TelerikBlazor GitHub App](https://github.com/apps/telerikblazor) page and click the **Install** button.
29+
1. Go to the [TelerikBlazor GitHub App](https://github.com/apps/telerikblazor) page and click the **Install** button. If you have already installed the extension,you will see a **Configure** button instead.
3030
1. You will see a list that includes your GitHub account and all GitHub organizations that you are part of. Normally, select your GitHub account.
3131
1. Click the **Install & Authorize** button. This will authorize the GitHub Copilot extension to integrate with your GitHub account.
3232
1. Enter your GitHub password.
@@ -35,7 +35,7 @@ To install the Telerik Blazor Copilot extension:
3535
1. Restart your [Copilot-enabled apps](https://docs.github.com/en/copilot/building-copilot-extensions/about-building-copilot-extensions#supported-clients-and-ides) (for example, Visual Studio and VS Code).
3636
1. Start a new chat session in Copilot.
3737

38-
> You can also use the automated installation commands provided by the Telerik extensions for [Visual Studio](slug:getting-started-vs-integration-ai-configuration) and [VS Code](slug:getting-started-vs-code-integration-ai-configuration) to quickly open the installation page.
38+
You can also start the installation from the Telerik UI for Blazor extensions for [Visual Studio](slug:getting-started-vs-integration-ai-configuration#install-telerik-blazor-copilot-extension) and [VS Code](slug:getting-started-vs-code-integration-ai-configuration). Then, continue the installation from step 2.
3939

4040
## Usage
4141

‎getting-started/vs-code-integration/ai-configuration.md‎

Lines changed: 29 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -1,85 +1,51 @@
11
---
2-
title: AI Configuration
3-
page_title: Visual Studio Code AI Configuration
4-
description: Learn how to configure AI-powered tools like MCP servers and GitHub Copilot for Telerik UI for Blazor development in Visual Studio Code.
2+
title: AI Tools Configuration
3+
page_title: AI Tools Configuration in VS Code
4+
description: Learn how to configure Telerik AI-powered tools like the MCP server and GitHub Copilot extension for Telerik UI for Blazor development in Visual Studio Code (VS Code).
55
slug: getting-started-vs-code-integration-ai-configuration
6-
position: 8
6+
position: 4
77
---
88

9-
# AI Configuration in Visual Studio Code
9+
# AI Tools Configuration in VS Code
1010

11-
The Telerik UI for Blazor Extension for Visual Studio Code provides automated configuration commands for AI-powered development tools. These commands help you quickly set up [MCP servers](slug:ai-mcp-server) and [GitHub Copilot](slug:ai-copilot-extension) for enhanced developer productivity with Telerik UI for Blazor components.
11+
The Telerik UI for Blazor Extension for VS Code @[template](/_contentTemplates/common/ai-coding-assistant.md#vs-intro)
1212

13-
## Available Commands
14-
15-
To access these commands, press `Ctrl`+`Shift`+`P` on Windows/Linux or `Cmd`+`Shift`+`P` on Mac to open the VS Code command palette, then search for the following Telerik commands:
16-
17-
### Configure MCP Server
18-
19-
The **Telerik UI for Blazor: Configure MCP Server** command automatically creates the necessary configuration file for the [Telerik Blazor MCP Server](slug:ai-mcp-server). This command provides two configuration scopes:
20-
21-
* **Workspace Scope** - Creates an `mcp.json` file under the `.vscode` folder in your current workspace. This configuration applies only to the current workspace.
22-
* **Global Scope** - Creates an `mcp.json` file under `C:\Users\[username]\AppData\Roaming\Code\User\` (Windows) or the equivalent user configuration directory on other platforms. This configuration applies to all VS Code workspaces.
23-
24-
The generated `mcp.json` file includes the proper configuration for the Telerik Blazor MCP server with placeholder values for your Telerik license. You need to update the license path or key in the generated file.
25-
26-
>caption Generated .vscode/mcp.json (Workspace Scope)
27-
28-
```json
29-
{
30-
"servers": {
31-
"telerikBlazorAssistant": {
32-
"type": "stdio",
33-
"command": "npx",
34-
"args": ["-y", "@progress/telerik-blazor-mcp@latest"],
35-
"env": {
36-
"TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
37-
}
38-
}
39-
}
40-
}
41-
```
42-
43-
> Make sure to update the `TELERIK_LICENSE_PATH` value with your actual [Telerik license file location](slug:installation-license-key), or replace it with a `TELERIK_LICENSE` key containing your license key directly.
13+
## Prerequisites
4414

45-
### Add GitHub Copilot Custom Instructions
15+
To set up the Telerik UI for Blazor AI tools automatically:
4616

47-
The **Telerik UI for Blazor: Add GitHub Copilot Custom Instructions** command generates a `copilot-instructions.md` file under the `.github` folder in your current workspace. This file contains custom instructions that help GitHub Copilot provide better assistance when working with Telerik UI for Blazor components.
17+
* [Install the Telerik UI for Blazor extension for VS Code](slug:getting-started-vs-code-integration-overview).
18+
@[template](/_contentTemplates/common/ai-coding-assistant.md#prerequisites)
4819

49-
The generated file includes:
50-
* Best practices for Razor component development
51-
* Telerik UI for Blazor specific coding guidelines
52-
* Component naming conventions
53-
* Recommended code structure patterns
20+
To access the automated commands:
5421

55-
### Install Telerik Blazor Copilot Extension
22+
1. Open the [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) at the center top of the VS Code interface.
23+
1. Select **Show and Run Commands**.
24+
1. Search for the following Telerik commands:
25+
* [Configure MCP Server](#configure-mcp-server)
26+
* [Install Telerik Blazor Copilot Extension](#install-telerik-blazor-copilot-extension)
27+
* [Add GitHub Copilot Custom Instructions](#add-github-copilot-custom-instructions)
5628

57-
The **Telerik UI for Blazor: Install Telerik Blazor Copilot Extension** command opens the GitHub App installation page in your default browser:
29+
## Configure MCP Server
5830

59-
`https://github.com/apps/telerikblazor/installations/select_target`
31+
The **Telerik UI for Blazor: Configure MCP Server** command provides two configuration scopes to set up the [Telerik Blazor MCP Server](slug:ai-mcp-server#vs-code):
6032

61-
This allows you to quickly install the [Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension) for your GitHub account or organization.
33+
* **Workspace**—Creates an `mcp.json` file in a `.vscode` folder in your current workspace. This configuration applies only to the current workspace.
34+
* **Global**—Creates an `mcp.json` file in your operating system user folder (for example, `C:\Users\_____\AppData\Roaming\Code\User\.mcp.json` on Windows or `/Users/_____/Library/Application Support/Code/User/mcp.json` on macOS). This configuration applies to all VS Code workspaces.
6235

63-
## Prerequisites
36+
> Make sure to open the generated `mcp.json` @[template](/_contentTemplates/common/ai-coding-assistant.md#verify-license-key)
6437
65-
Before using these AI configuration commands, ensure you have:
38+
Finally, check for any [usage notes about the Telerik Blazor MCP Server](slug:ai-mcp-server#vs-code).
6639

67-
* A [Telerik user account](https://www.telerik.com/account/)
68-
* An active [DevCraft or Telerik UI for Blazor license](https://www.telerik.com/purchase/blazor-ui) or [trial](https://www.telerik.com/blazor-ui)
69-
* [Node.js](https://nodejs.org/en) 18 or newer (for MCP server functionality)
70-
* The latest version of the Telerik UI for Blazor VS Code extension
40+
## Add GitHub Copilot Custom Instructions
7141

72-
## Next Steps
42+
The **Telerik UI for Blazor: Add GitHub Copilot Custom Instructions** @[template](/_contentTemplates/common/ai-coding-assistant.md#copilot-instructions)
7343

74-
After configuring the AI tools:
44+
## Install Telerik Blazor Copilot Extension
7545

76-
1. **For MCP Server**: Follow the [complete MCP server setup guide](slug:ai-mcp-server) to understand usage and troubleshooting.
77-
2. **For GitHub Copilot**: Learn how to use the [Telerik Blazor Copilot Extension](slug:ai-copilot-extension) effectively.
78-
3. **For both**: Review the [AI tooling overview](slug:ai-overview) to understand the capabilities and limitations of these tools.
46+
The **Telerik UI for Blazor: Install Telerik Blazor Copilot Extension** @[template](/_contentTemplates/common/ai-coding-assistant.md#command-github-app)
7947

8048
## See Also
8149

82-
* [Telerik Blazor MCP Server](slug:ai-mcp-server)
83-
* [Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension)
84-
* [AI Tooling Overview](slug:ai-overview)
85-
* [VS Code Integration Overview](slug:getting-started-vs-code-integration-overview)
50+
@[template](/_contentTemplates/common/ai-coding-assistant.md#see-also)
51+
* [VS Code Integration Overview](slug:getting-started-vs-code-integration-overview)

‎getting-started/vs-code-integration/troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Тroubleshooting
33
page_title: Visual Studio Code Integration Overview
44
description: Learn how to enhance your experience in developing web applications with Progress Telerik UI for Blazor.
55
slug: getting-started-vs-code-integration-troubleshooting
6-
position: 4
6+
position: 10
77
---
88

99
# Troubleshooting

‎getting-started/vs-integration/ai-configuration.md‎

Lines changed: 22 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -1,96 +1,44 @@
11
---
2-
title: AI Configuration
3-
page_title: Visual Studio AI Configuration
4-
description: Learn how to configure AI-powered tools like MCP servers and GitHub Copilot for Telerik UI for Blazor development in Visual Studio.
2+
title: AI Tools Configuration
3+
page_title: AI Tools Configuration in Visual Studio
4+
description: Learn how to configure Telerik AI-powered tools like the MCP server and GitHub Copilot extension for Telerik UI for Blazor development in Visual Studio.
55
slug: getting-started-vs-integration-ai-configuration
66
position: 8
77
---
88

9-
# AI Configuration in Visual Studio
9+
# AI Tools Configuration in Visual Studio
1010

11-
The Telerik UI for Blazor Extension for Visual Studio provides automated configuration commands for AI-powered development tools. These commands help you quickly set up [MCP servers](slug:ai-mcp-server) and [GitHub Copilot](slug:ai-copilot-extension) for enhanced developer productivity with Telerik UI for Blazor components.
11+
The Telerik UI for Blazor Extension for Visual Studio @[template](/_contentTemplates/common/ai-coding-assistant.md#vs-intro)
1212

13-
## Available Commands
14-
15-
To access these commands, go to **Extensions** > **Telerik** > **Telerik UI for Blazor** in the Visual Studio menu.
16-
17-
### Configure MCP Server
18-
19-
The Telerik UI for Blazor extension provides two MCP server configuration options:
20-
21-
#### Configure MCP Server for Solution
22-
23-
The **Configure MCP Server for Solution** command generates a `.mcp.json` file in the solution folder. This configuration applies only to the current solution and any projects within it.
24-
25-
#### Configure MCP Server Globally
26-
27-
The **Configure MCP Server Globally** command generates a `.mcp.json` file under the user profile directory (`%USERPROFILE%`, for example, `C:\Users\<yourusername>`). This configuration applies to all Visual Studio solutions and projects.
28-
29-
Both commands create a properly configured `.mcp.json` file for the [Telerik Blazor MCP Server](slug:ai-mcp-server) with placeholder values for your Telerik license.
30-
31-
>caption Generated .mcp.json
32-
33-
```json
34-
{
35-
"servers": {
36-
"telerikBlazorAssistant": {
37-
"type": "stdio",
38-
"command": "npx",
39-
"args": ["-y", "@progress/telerik-blazor-mcp@latest"],
40-
"env": {
41-
"TELERIK_LICENSE_PATH": "C:\\Users\\___\\AppData\\Roaming\\Telerik\\telerik-license.txt"
42-
}
43-
}
44-
}
45-
}
46-
```
47-
48-
> Make sure to update the `TELERIK_LICENSE_PATH` value with your actual [Telerik license file location](slug:installation-license-key), or replace it with a `TELERIK_LICENSE` key containing your license key directly.
49-
50-
### Add/Update Copilot Instructions
51-
52-
The **Add/Update Copilot Instructions** command generates a `copilot-instructions.md` file in the `.github` folder under the solution. This file contains custom instructions that help GitHub Copilot provide better assistance when working with Telerik UI for Blazor components.
53-
54-
The generated file includes:
55-
* Best practices for Razor component development
56-
* Telerik UI for Blazor specific coding guidelines
57-
* Component naming conventions
58-
* Recommended code structure patterns
13+
## Prerequisites
5914

60-
### Install Telerik Blazor Copilot Extension
15+
To set up the Telerik UI for Blazor AI tools automatically:
6116

62-
The **Install Telerik Blazor Copilot Extension** command opens the GitHub App installation page in your default browser:
17+
* [Install the Telerik UI for Blazor extension for Visual Studio](slug:getting-started-vs-integration-overview).
18+
@[template](/_contentTemplates/common/ai-coding-assistant.md#prerequisites)
6319

64-
`https://github.com/apps/telerikblazor/installations/select_target`
20+
To access the automated commands, open **Extensions** > **Telerik** > **Telerik UI for Blazor** in the Visual Studio menu.
6521

66-
This allows you to quickly install the [Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension) for your GitHub account or organization.
22+
## Configure Telerik MCP Server
6723

68-
## Prerequisites
24+
The Telerik UI for Blazor extension provides two menu options to [set up the Telerik Blazor MCP server](slug:ai-mcp-server#visual-studio):
6925

70-
Before using these AI configuration commands, ensure you have:
26+
* **Configure MCP Server for Solution**&mdash;this command creates an `.mcp.json` file in the solution folder. The configuration applies only to the projects in that application.
27+
* **Configure MCP Server Globally**&mdash;this command creates an `.mcp.json` file in your operating system user folder (`%USERPROFILE%`, for example, `C:\Users\_____\.mcp.json`). This configuration applies to all Visual Studio solutions and projects.
7128

72-
* A [Telerik user account](https://www.telerik.com/account/)
73-
* An active [DevCraft or Telerik UI for Blazor license](https://www.telerik.com/purchase/blazor-ui) or [trial](https://www.telerik.com/blazor-ui)
74-
* [Node.js](https://nodejs.org/en) 18 or newer (for MCP server functionality)
75-
* Visual Studio 2022 or 2019 with the latest Telerik UI for Blazor extension
29+
> Make sure to open the generated `.mcp.json` @[template](/_contentTemplates/common/ai-coding-assistant.md#verify-license-key)
7630
77-
## Important Notes for Visual Studio
31+
Finally, check for any [usage notes about the Telerik Blazor MCP Server](slug:ai-mcp-server#visual-studio).
7832

79-
* Early Visual Studio 17.14 versions require the Copilot Chat window to be open and active when you open a solution for the MCP server to work properly.
80-
* After configuring the MCP server, make sure that the `telerikBlazorAssistant` tool is [enabled (checked) in the Copilot Chat window's tool selection dropdown](https://learn.microsoft.com/en-us/visualstudio/ide/mcp-servers?view=vs-2022#configuration-example-with-github-mcp-server).
81-
* The Telerik MCP server may get disabled and you may see "🔧10/11" in the selected tools dropdown when starting a new chat, changing threads, or relaunching Visual Studio. This is a known issue that is being investigated.
33+
## Add/Update Copilot Instructions
8234

83-
## Next Steps
35+
The **Add/Update Copilot Instructions** @[template](/_contentTemplates/common/ai-coding-assistant.md#copilot-instructions)
8436

85-
After configuring the AI tools:
37+
## Install Telerik Blazor Copilot Extension
8638

87-
1. **For MCP Server**: Follow the [complete MCP server setup guide](slug:ai-mcp-server) to understand usage and troubleshooting.
88-
2. **For GitHub Copilot**: Learn how to use the [Telerik Blazor Copilot Extension](slug:ai-copilot-extension) effectively.
89-
3. **For both**: Review the [AI tooling overview](slug:ai-overview) to understand the capabilities and limitations of these tools.
39+
The **Install Telerik Blazor Copilot Extension** @[template](/_contentTemplates/common/ai-coding-assistant.md#command-github-app)
9040

9141
## See Also
9242

93-
* [Telerik Blazor MCP Server](slug:ai-mcp-server)
94-
* [Telerik Blazor GitHub Copilot Extension](slug:ai-copilot-extension)
95-
* [AI Tooling Overview](slug:ai-overview)
96-
* [Visual Studio Integration Overview](slug:getting-started-vs-integration-overview)
43+
@[template](/_contentTemplates/common/ai-coding-assistant.md#see-also)
44+
* [Visual Studio Integration Overview](slug:getting-started-vs-integration-overview)

0 commit comments

Comments
 (0)