Skip to content

Commit 654659e

Browse files
authored
Update Visual Studio extention documentation (#2287)
* docs(common): update vs extention documentation * apply suggested changes
1 parent 085469b commit 654659e

17 files changed

+42
-64
lines changed

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

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,14 @@ The configuration wizard handles the following tasks:
2424

2525
The **Theme Selection** page enables you to change the [CSS theme]({%slug themes-built-in%}) of your Telerik UI for Blazor application.
2626

27-
![Theme Selection menu in the Project Configuration Wizard](../vs-integration/images/configure-theme.png)
28-
2927
After selecting the desired theme, click **Next** to navigate to the [Project Settings](#project-settings) page.
3028

3129
## Project Settings
3230

33-
The **Project Settings** page allows you to enable or disable the [Telerik UI CDN support]({%slug common-features-cdn%}). Note that this can affect the future [upgrade process of the theme]({%slug getting-started-vs-integration-new-project%}#step-3-configure-additional-project-settings).
31+
The **Project Settings** page allows you to enable or disable:
3432

35-
![Project Settings dialog in the Project Configuration Wizard](../vs-integration/images/configure-settings.png)
33+
* The [Telerik UI CDN support]({%slug common-features-cdn%}). Note that this can affect the future [upgrade process of the theme]({%slug upgrade-tutorial%}#upgrade-process).
34+
* The [Font Icons]({%slug common-features-icons%}) in the project.
3635

3736
## See Also
3837

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

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -57,18 +57,32 @@ Alternatively, instead of the context menu, you can use the VS **Extensions** me
5757
5858
![Start the Convert Project Wizard](images/vs-ext-convert-project-entry.png)
5959

60-
## Features
60+
## Converting the Project
6161

62-
The wizard provides you with the following options:
62+
Clicking the Convert to Telerik Application button opens the Convert Project Wizard and you will go through the following steps:
6363

64-
* The ability to download the latest available version.
65-
* A version selector so you can choose a particular version to add to the project.
66-
* A list with the versions found on your machine that you can choose from.
67-
* Whether to back up the project state before the conversion (in a folder called `<ProjectName>_Backup>_<timestamp>`).
64+
1. [Configure the project](#step-1-select-initial-project-configuration).
65+
1. [Select a visual theme](#step-2-select-theme).
66+
1. [Create a backup](#step-3-create-a-backup).
6867

69-
>caption The Convert Project Wizard Options
68+
### Step 1: Select Initial Project Configuration
7069

71-
![The Convert Project Wizard Options](images/convert-project-wizard-options.png)
70+
This screen provides the ability to:
71+
72+
* Download the latest available version.
73+
* Choose a particular version to add to the project.
74+
* Configure additional project settings like:
75+
* Load the required Telerik UI stylesheet and JS Interop file as [static assets]({%slug getting-started/what-you-need%}#css-theme-and-javascript-files) or from the [Telerik CDN]({%slug common-features-cdn%}).
76+
* Enable [localization]({%slug globalization-localization%}).
77+
* Use [font icons]({%slug common-features-icons%}) instead of the default SVG icons.
78+
79+
### Step 2: Select Theme
80+
81+
In this step, you can apply one of the available [themes]({%slug themes-built-in%}) to your project.
82+
83+
### Step 3: Create a Backup
84+
85+
You can choose to back up the project state before the conversion (in a folder called `<ProjectName>_Backup>_<timestamp>`).
7286

7387
## Troubleshooting
7488

@@ -80,14 +94,10 @@ When converting a project, you may encounter the following most common issues:
8094

8195
### Error Screen
8296

83-
If you see an error screen similar to the one below, make sure that the actual Blazor application is selected in the Solution Explorer. This is most common with WebAssembly types of applications as they consist of a server and shared projects by default, and only the client project is the actual Blazor app that needs the Telerik components.
97+
If you see an error screen in the wizard, make sure that you have selected the UI project in the Solution Explorer. For example, the Issue can occur in WebAssembly apps as they can include a Server and Shared projects, and only the Client project is the actual Blazor UI app that needs the Telerik components.
8498

8599
Some specific project settings can also cause an exception during conversion. The fastest solution is to [manually configure the project for the Telerik components]({%slug getting-started/what-you-need%}).
86100

87-
>caption Error screen when the project can't be converted
88-
89-
![The Convert Project Failed](images/convert-project-wizard-failed.png)
90-
91101
### Components Fail
92102

93103
The issue can manifest in a couple of ways:
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

0 commit comments

Comments
 (0)