Update Visual Studio extention documentation (#2287)

* docs(common): update vs extention documentation

* apply suggested changes

Author: Tsvetomir-Hr

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

@@ -24,15 +24,14 @@ The configuration wizard handles the following tasks:
 
 The **Theme Selection** page enables you to change the [CSS theme]({%slug themes-built-in%}) of your Telerik UI for Blazor application.
 
-![Theme Selection menu in the Project Configuration Wizard](../vs-integration/images/configure-theme.png)
-
 After selecting the desired theme, click **Next** to navigate to the [Project Settings](#project-settings) page.
 
 ## Project Settings
 
-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).
+The **Project Settings** page allows you to enable or disable:
 
-![Project Settings dialog in the Project Configuration Wizard](../vs-integration/images/configure-settings.png)
+* 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).
+* The [Font Icons]({%slug common-features-icons%}) in the project.
 
 ## See Also
 

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

@@ -57,18 +57,32 @@ Alternatively, instead of the context menu, you can use the VS **Extensions** me
 
 ![Start the Convert Project Wizard](images/vs-ext-convert-project-entry.png)
 
-## Features
+## Converting the Project
 
-The wizard provides you with the following options:
+Clicking the Convert to Telerik Application button opens the Convert Project Wizard and you will go through the following steps:
 
-* The ability to download the latest available version.
-* A version selector so you can choose a particular version to add to the project.
-* A list with the versions found on your machine that you can choose from.
-* Whether to back up the project state before the conversion (in a folder called `<ProjectName>_Backup>_<timestamp>`).
+1. [Configure the project](#step-1-select-initial-project-configuration).
+1. [Select a visual theme](#step-2-select-theme).
+1. [Create a backup](#step-3-create-a-backup).
 
->caption The Convert Project Wizard Options
+### Step 1: Select Initial Project Configuration
 
-![The Convert Project Wizard Options](images/convert-project-wizard-options.png)
+This screen provides the ability to:
+
+* Download the latest available version.
+* Choose a particular version to add to the project.
+* Configure additional project settings like:
+    * 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%}).
+    * Enable [localization]({%slug globalization-localization%}).
+    * Use [font icons]({%slug common-features-icons%}) instead of the default SVG icons.
+
+### Step 2: Select Theme
+
+In this step, you can apply one of the available [themes]({%slug themes-built-in%}) to your project.
+
+### Step 3: Create a Backup
+
+You can choose to back up the project state before the conversion (in a folder called `<ProjectName>_Backup>_<timestamp>`).
 
 ## Troubleshooting
 
@@ -80,14 +94,10 @@ When converting a project, you may encounter the following most common issues:
 
 ### Error Screen
 
-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.
+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.
 
 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%}).
 
->caption Error screen when the project can't be converted
-
-![The Convert Project Failed](images/convert-project-wizard-failed.png)
-
 ### Components Fail
 
 The issue can manifest in a couple of ways:

getting-started/vs-integration/images/click-to-log-in.png

@@ -24,19 +24,13 @@ Clicking the **Get Latest** button in the [Create New Project]({% slug getting-s
 
 1. Click on the LOG IN button. This will open a browser window with a login form on the telerik.com website.
 
-    ![Log into your Telerik account](images/click-to-log-in.png)
-
     >tip For more information on the latest available versions, see the [Telerik UI for Blazor release notes](https://www.telerik.com/support/whats-new/blazor-ui/release-history).
 
 1. Enter your Telerik credentials in the browser. If you do not have a [www.telerik.com](https://www.telerik.com) account, then create a new one.
 1. Return to Visual Studio and confirm any privacy-related requests.
 1. In the next dialog that appears, click the **Download** button.
 
-    ![Confirming the download of the latest version dialog](images/download-new-version.png)
-
-1. Return to the [Create New Project]({% slug getting-started-vs-integration-new-project %}) wizard and select the newly downloaded version from the drop-down menu.
-
-    ![The new version is now available in the New Project wizard](images/new-version-in-new-project-wizard.png)
+1. Return to the [Create New Project]({% slug getting-started-vs-integration-new-project %}) wizard and select the newly downloaded version.
 
 The Latest Version Acquirer tool downloads a `.zip` file that contains the latest Telerik UI for Blazor packages. By default, the file is saved in the `%APPDATA%\Telerik\Updates` folder. If the list with the offered packages gets too long and you do not need the prior versions, close VS and use the Windows Explorer to delete these distributions.
 

getting-started/vs-integration/images/configure-settings.png

@@ -58,12 +58,20 @@ After you select the **Create New Project** option from the **Extensions** menu,
 
 Clicking the **Create** button in this window opens the wizard and you will go through the following steps:
 
+1. [Select Initial Project Configuration](#step-1-select-initial-project-configuration).
+1. [Select Project Template](#step-2-select-project-template).
+1. [Select a visual theme](#step-3-select-theme).
+
 ### Step 1: Select Initial Project Configuration
 
 In this screen, you can choose:
 
 * Target .NET framework
 * Hosting model—the options vary depending on the selected target framework.
+* Configure additional project settings like:
+   * 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%}). Note that this can affect the future [upgrade process of the theme]({%slug upgrade-tutorial%}#upgrade-process).
+   * Enable [localization]({%slug globalization-localization%}).
+   * Use [font icons]({%slug common-features-icons%}) instead of the default SVG icons.
 * Location from where the application will get the Telerik UI for Blazor package—[remote NuGet feed]({%slug installation/nuget%}) or local files.
 * Telerik UI for Blazor version.
 
@@ -82,19 +90,7 @@ The **Create New Project** wizard provides the following project templates:
 * **Dashboard**—A basic dashboard layout that uses the TileLayout component for customizable dashboards, and showcases several ways individual blocks (tiles) can fetch data.
 * **Admin**—A small app that shows a dashboard for admin. The app uses some of the main Telerik UI components like the [Data Grid]({%slug grid-overview%}), [Chart]({%slug components/chart/overview%}), [TileLayout]({%slug tilelayout-overview%}), [Form]({%slug form-overview%}), and more.
 
-### Step 3: Configure Additional Project Settings
-
-This screen lets you choose:
-
-   * Whether to import the required Telerik UI stylesheet and JS Interop file by using the [static assets]({%slug getting-started/what-you-need%}#css-theme-and-javascript-files) or the [CDN method]({%slug common-features-cdn%}).
-   * Whether to use [localization]({%slug globalization-localization%}) in the project or not.
-   * Whether to use [Font Icons]({%slug common-features-icons%}) in the project or the default SVG icons.
-
-#### Using Local Theme
-
-When using a local theme, the CSS file is saved locally in the `wwwroot/lib/blazor-ui/styles` folder of the application. With this configuration, upgrading UI for Blazor requires you to [replace this CSS file manually]({%slug upgrade-tutorial%}).
-
-### Step 4: Select Theme
+### Step 3: Select Theme
 
 Finally, you can apply one of the available [themes]({%slug themes-built-in%}) to your project.
 

getting-started/vs-integration/images/configure-theme.png

@@ -20,8 +20,6 @@ The **Upgrade Project Wizard** upgrades the version of existing Telerik UI for B
 
 The **Upgrade Information** step of the Upgrade Project Wizard describes the files and assemblies that will be upgraded.
 
-![Upgrade Wizard Information Page](images/upgrade-wizard-information.png)
-
 The Telerik Blazor Upgrade Wizard will do the following:
 
 * Update the version of the referenced Blazor NuGet package. It will also update the package source in the solution-based NuGet config file.
@@ -35,47 +33,28 @@ The next page of the Upgrade Wizard lists all projects from the solution that us
 
 >tip We recommend selecting all projects that reference UI for Blazor and upgrading them to the same product version.
 
-![Upgrade Wizard Projects Selection](images/upgrade-wizard-projects.png)  
-
 ## Upgrade Localization File
 
 If localization is enabled in the application, you can select the **Upgrade the localization file** option. The Upgrade Wizard will add new localization keys from the default (English) localization file that UI for Blazor distributes.
 
-The option is selected by default if there is a **Resources\TelerikMessages.resx** file in the current project. In this case, **Resources\TelerikMessages.resx** file is selected in the file browser.
-
-![Upgrade Wizard Localization File](images/upgrade-wizard-localization-file.png)  
+The option is selected by default if there is a `Resources\TelerikMessages.resx` file in the current project. In this case, `Resources\TelerikMessages.resx` file is selected in the file browser. 
 
 ## Create Backup
 
 You can create a backup before running the upgrade wizard by selecting the **Create a backup before upgrading** option.
 
->When the project and solution are placed in the same directory, the default backup location is set to the **%USERPROFILE%\Documents** folder.
-
-![Upgrade Wizard Backup](images/upgrade-wizard-backup.png)  
-
+>When the project and solution are placed in the same directory, the default backup location is set to the `%USERPROFILE%\Documents` folder.
 
 ## Upgrade Log
 
-In case one of the options ([Create a backup before upgrading](#create-backup) or [Upgrade the localization file](#upgrade-localization-file)) is selected, an **Upgrade Log** will be opened in your default browser at the end of the upgrade. The log can show the backup location, an entry for each localization key added or a localization upgrade error. Each upgrade log file is in HTML format. The file name contains the date and time of the upgrade.
-
-![Upgrade Wizard Log](images/upgrade-wizard-backup.png)
+In case one of the options ([Create a backup before upgrading](#create-backup) or [Upgrade the localization file](#upgrade-localization-file)) is selected, an **Upgrade Log** will open at the end of the upgrade. The log can show the backup location, an entry for each localization key added or a localization upgrade error. Each upgrade log file is in HTML format. The file name contains the date and time of the upgrade.
 
 ## Troubleshooting
 
-The following common problems might occur when upgrading a project:
-
-* The [localization file is read-only or does not exists](#missing-localization-file).
-* The [**Finish** button is disabled](#finish-button-is-disabled).
-
-### Missing Localization file
-
-If the selected localization file in the pointed directory is missing or read-only, the page state is not valid. In this case, the **Finish** button will display a tooltip when clicked, indicating a page error.
-
-![Upgrade Wizard Localization File](images/upgrade-wizard-localization-file-invalid.png)
-
-### Finish Button is Disabled
+The **Finish** button will display a tooltip, indicating a page error when:
 
-If **Create a backup before upgrading** option is selected, and the **Backup location** is empty, the **Finish** button is disabled.
+* The **Upgrade the localization file** option is selected and the pointed directory is empty or the file is read-only.
+* The **Create a backup before upgrading** option is selected, and the backup location is empty.
 
 ## See Also