docs(vsx): troubleshooting for upgrade wizard

marin-bratanov · marin-bratanov · commit 0d03e38e4a86 · 2020-05-11T19:40:42.000+03:00
diff --git a/_contentTemplates/common/general-info.md b/_contentTemplates/common/general-info.md
@@ -60,4 +60,14 @@ You can reference the built-in Telerik assets from a cloud CDN instead of a loca
 
 >note We are considering a better CDN option for the themes. Until then, you can use the unpkg workaround above, or local dependency management as described below.
 
+#end
+
+
+
+#vsx-download
+You can get them from the:
+
+* [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=TelerikInc.TelerikBlazorVSExtensions)
+* [Telerik UI for Blazor automated installer]({%slug installation/msi%})
+
 #end
diff --git a/getting-started/vs-integration/convert-project-wizard.md b/getting-started/vs-integration/convert-project-wizard.md
@@ -12,6 +12,14 @@ This article demonstrates how to enable the Progress&reg; Telerik&reg; UI for Bl
 
 To add the Telerik Components to you existing Blazor application, use the use the **Convert Project Wizard**. The wizard detects all installed versions of Telerik UI for Blazor and lists them in the **Version** combobox&mdash;this enables you to start your project with the desired version. You can also [get the latest version]({%slug getting-started-vs-integration-latest-version%}) to make sure you are up to date.
 
+## Get the Wizard
+
+To use the **Convert Project Wizard**, install the Telerik UI for Blazor Visual Studio Extensions. @[template](/_contentTemplates/common/general-info.md#vsx-download)
+
+
+
+## Start the Wizard
+
 To start the wizard, do the following:
 
 1. In the **Solution Explorer**, select the Blazor app you want to add the Telerik components to (either WebAssembly, or Server-side Blazor)
@@ -40,6 +48,35 @@ To get a better understanding of what the wizard does for you, see either of the
 * [Getting Started with Server-side apps]({%slug getting-started/server-side%})
 * [Overview of what you need]({%slug getting-started/what-you-need%})
 
+## Troubleshooting
+
+There are two common problems when converting a project:
+
+* The convertion wizard fails with an [error screen](#error-screen)
+* The [Telerik components do not work](#components-fail) after you run the converted project
+
+### 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 WebAssemly 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.
+
+In case the automation fails for other reasons and you see an exception dialog message from the Telerik extensions, it is likely that something a bit peculiar is happening with the particular project and you would have to perform the steps by hand. There are only three, and you can find them in the [What You Need]({%slug getting-started/what-you-need%}) article.
+
+>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:
+
+* The components have no styling
+* There are JavaScript errors that Telerik objects cannot be found
+
+The most common reason for this problem is a mismatch between the installed version and the actual license that you have. For example, the wizard did not properly detect it, or there is only a Trial version installed, but already have a license, but simply never installed the new version.
+
+At its root, the problem stems from wrong paths to the needed web assets and you can easily fix it by opening your index file (`wwwroot/index.html` for a WebAssembly app, and `Pages/_Host.cshtml` for a server-side Blazor app) - the wizard has left comments in the `<head>` near the Telerik assets that show the correct paths for a trial and commercial license.
+
 
 
 ## See Also
diff --git a/getting-started/vs-integration/images/convert-project-wizard-options.png b/getting-started/vs-integration/images/convert-project-wizard-options.png
diff --git a/getting-started/vs-integration/introduction.md b/getting-started/vs-integration/introduction.md
@@ -21,10 +21,7 @@ The Telerik Blazor Extensions provide the following advantages:
 
 The Telerik UI for Blazor VS extensions support Visual Studio 2019.
 
-You can get them from the:
-
-* [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=TelerikInc.TelerikBlazorVSExtensions)
-* [Telerik UI for Blazor automated installer]({%slug installation/msi%})
+@[template](/_contentTemplates/common/general-info.md#vsx-download)
 
 To access the VS extensions, go to the **Extensions** > **Telerik** > **Telerik UI for Blazor** menu.
 
diff --git a/getting-started/vs-integration/new-project-wizard.md b/getting-started/vs-integration/new-project-wizard.md
@@ -12,6 +12,13 @@ This article demonstrates how to create a new application that has the Progress&
 
 To create a new Telerik UI for Blazor application, use the **Create New Project Wizard**. The wizard detects all installed versions of Telerik UI for Blazor and lists them in the **Version** combobox&mdash;this enables you to start your project with the desired version. You can also [get the latest version]({%slug getting-started-vs-integration-latest-version%}) to make sure you are up to date.
 
+## Get the Wizard
+
+To use the **Create New Project Wizard**, install the Telerik UI for Blazor Visual Studio Extensions. @[template](/_contentTemplates/common/general-info.md#vsx-download)
+
+
+## Start the Wizard
+
 To start the wizard, use either of the following approaches:
 
 * Using the **Extensions** menu:
