VS Extensions

_config.yml

@@ -33,7 +33,7 @@ navigation:
      "how-to":
         title: "How To"
         position: 20
-     "vs-integration":
+     "getting-started/vs-integration":
         title: "Visual Studio Integration"
         position: 25
      "backwards-compatibility":

getting-started/vs-integration/introduction.md

@@ -0,0 +1,29 @@
+---
+title: Overview
+page_title: Visual Studio Integration Overview | Telerik UI for Blazor
+description: "Learn how to enhance your experience in developing web applications with Progress Telerik UI for Blazor."
+slug: getting-started-vs-integration-overview
+position: 1
+---
+
+# Visual Studio Integration Overview
+
+The Progress® Telerik® UI for Blazor Visual Studio (VS) Extensions enhance the experience in developing Blazor web applications with Telerik UI for Blazor.
+
+As their primary advantage, the VS extensions facilitate the [creation of projects]({% slug getting-started-vs-integration-new-project %}). They can also give you notifications to [get the latest version]({%slug getting-started-vs-integration-latest-version %}).
+
+The Telerik UI for Blazor VS extensions support Visual Studio 2019 Preview. You can get them from the:
+
+* [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=TelerikInc.TelerikBlazorVSExtensions)
+* [Telerik UI for Blazor MSI installer]({%slug installation/msi%})
+
+To access the VS extensions, go to the **Extensions** > **Telerik** > **Telerik UI for Blazor** menu.
+
+![](images/open-vs-extensions.png)
+
+
+
+## See Also
+
+* [Creating New Projects with Visual Studio]({% slug getting-started-vs-integration-new-project %})
+* [Downloading the Latest Telerik UI for Blazor Versions]({% slug getting-started-vs-integration-latest-version %})

getting-started/vs-integration/latest-version-retrieval.md

@@ -0,0 +1,50 @@
+---
+title: Download New Versions
+page_title: Download New Versions | Visual Studio Integration | Telerik UI for Blazor
+description: "Learn how to keep your projects updated when using Progress® Telerik® UI for Blazor."
+slug: getting-started-vs-integration-latest-version
+position: 3
+---
+
+# Download New Versions
+
+The Progress® Telerik® UI for Blazor Visual Studio (VS) extensions enable you to keep your projects updated.
+
+
+<!--
+The Latest Version Retrieval tool automatically checks for the latest Telerik UI for Blazor distribution which is available for you on the Telerik website. Once a day, upon loading a project with Telerik UI for Blazor components, the extensions query the Telerik website for a new version of Telerik UI for Blazor. When a new version is detected, a notification is displayed that lets you download it.
+
+![Getting the latest version notification](images/lva_notification.png)
+
+Clicking the **Update Now** button starts the Latest Version Acquirer tool which prompts for your Telerik credentials on its first page. If you do not have a [www.telerik.com](https://www.telerik.com) account, you can create one through the **Create an account for free** link.
+
+-->
+
+
+Clicking the **Get Latest** button on the [New Project Wizard]({% slug getting-started-vs-integration-new-project %}) starts the Latest Version Acquirer tool which prompts for your Telerik credentials on its first page. If you do not have a [www.telerik.com](https://www.telerik.com) account, you can create one through the **Create an account for free** link.
+
+1. Log in with your Telerik credentials
+
+    >tip To avoid having to enter your Telerik credentials multiple times, use the **Save my password** checkbox. The persistence is securely done and the credentials are saved in a per-user context. Other users on the machine do not have access to your stored credentials.
+
+    ![First, log in](images/login-vs-ext-download.png)
+
+    >tip You can go to the [release notes of Telerik UI for Blazor](https://www.telerik.com/support/whats-new/blazor-ui/release-history) to get information on the latest available versions and what they bring.
+
+1. In the dialog that appears, click the **Download** button and follow the next steps.
+
+    ![Confirming the download of the latest version dialog](images/download-new-version.png)
+
+1. To access the latest version of Telerik UI for Blazor that you just downloaded go to [New Project Wizard]({% slug getting-started-vs-integration-new-project %}).
+
+    >tip The **Download** and **Get Latest** buttons of the **New Project Wizard** launch the **Latest Version Acquirer** tool. If you are coming from them, you will be returned to that context, so you can choose the newer version now.
+
+    ![The new version is now available in the New Project wizard](images/new-version-in-new-project-wizard.png)
+    
+    
+>tip The **Latest Version Acquirer** tool downloads a `.zip` file which contains the latest Telerik UI for Blazor packages. It is saved in the `%APPDATA%\Telerik\Updates` folder by default. If you find the list of the offered packages too long and you do not need the older versions, close VS and use the Windows Explorer to delete these distributions.
+
+## See Also
+
+* [Visual Studio Extensions Overview]({% slug getting-started-vs-integration-overview %})
+* [Creating New Projects with Visual Studio]({% slug getting-started-vs-integration-new-project %})

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

@@ -0,0 +1,48 @@
+---
+title: Create New Project
+page_title: Create New Project | Visual Studio Integration | Telerik UI for Blazor
+description: "Learn how to create a new Progress® Telerik® UI for Blazor project with our Visual Studio Templates."
+slug: getting-started-vs-integration-new-project
+position: 2
+---
+
+# Create New Projects
+
+This article demonstrates how to create a new application that has the Progress® Telerik® UI for Blazor components working.
+
+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—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.
+
+To start the wizard, use either of the following approaches:
+
+* Using the **Extensions** menu:
+
+    1. Open the **Extensions** menu.
+    1. Click **Telerik** > **Telerik UI for Blazor** > **Create New Telerik Project**.
+    1. Follow the wizard.
+
+* Using the **Project** menu:
+
+    1. Click **File** > **New** > **Project**.
+    1. Find and click the **Telerik C# Blazor Application** option (you can use the search, or filter by Blazor templates).
+    1. Follow the wizard.
+
+You will have the standard options to select a location and name for your app, and then you will receive a list of predefined **Telerik templates** and the **Telerik Blazor versions** list to choose from:
+
+![The Create New Project Wizard Templates Options](images/new-project-wizard-templates-options.png)
+
+
+
+To get a better understanding of what the wizard does for you, see either of the following articles:
+
+* [Getting Started with Client-side apps]({%slug getting-started/client-side%})
+* [Getting Started with Server-side apps]({%slug getting-started/server-side%})
+* [Overview of what you need]({%slug getting-started/what-you-need%})
+
+## See Also
+
+* [Visual Studio Extensions Overview]({% slug getting-started-vs-integration-overview %})
+* [Downloading the Latest Telerik UI for Blazor Versions]({% slug getting-started-vs-integration-latest-version %})
+* [Getting Started with Client-side apps]({%slug getting-started/client-side%})
+* [Getting Started with Server-side apps]({%slug getting-started/server-side%})
+* [Overview of what you need]({%slug getting-started/what-you-need%})
+

getting-started/vs-integration/troubleshooting.md

@@ -0,0 +1,47 @@
+---
+title: Troubleshooting
+page_title: Troubleshooting | Visual Studio Integration | Telerik UI for Blazor
+description: "Troubleshooting steps for Progress® Telerik® UI for Blazor Visual Studio extensions."
+slug: getting-started-vs-integration-troubleshooting
+position: 4
+---
+
+# Troubleshooting
+
+This article provides solutions for common issues you may encounter while working with the Telerik UI for Blazor Visual Studio (VS) extensions.
+
+## The Telerik sub-menu is Missing from the Extensions Menu
+
+**Cause** The Visual Studio extensions are disabled or not correctly installed.
+
+**Solution** Depending on whether the extension is disabled or not correctly installed, use either of the following approaches.
+
+If the extension is disabled:
+
+1. Open Visual Studio.
+1. From the menu bar, select **Extensions** > **Manage Extensions**.
+1. Open the **Installed** tab.
+1. Search for **Telerik Blazor VSExtensions** and make sure they are **Enabled**.
+
+    ![Troubleshooting when the VS extension is disabled](images/enable-extensions.png)
+
+If the extensions are not correctly installed:
+
+1. Open Visual Studio.
+1. From the menu bar, select **Extensions** > **Manage Extensions**.
+1. Open the **Online** tab.
+1. Search for **Telerik Blazor VSExtensions**
+1. Download and install the extensions.
+
+If after you apply the described approaches the issue persists, contact the Support Team at Progress after you generate Visual Studio [ActivityLog](https://docs.microsoft.com/en-us/visualstudio/ide/reference/log-devenv-exe?view=vs-2019) file:
+
+1. Under **Administrative rights**, open the [**Developer Command** prompt](https://docs.microsoft.com/en-us/dotnet/framework/tools/developer-command-prompt-for-vs) for Visual Studio.
+1. Execute the `devenv /log %userprofile%\desktop\ActivityLog.xml` command to start Visual Studio and create logs on your Desktop.
+1. Reproduce the issue.
+1. Attach the `Activitylog` files when you contact our support.
+
+## See Also
+
+* [Visual Studio Extensions Overview]({% slug getting-started-vs-integration-overview %})
+* [Creating New Projects with Visual Studio]({% slug getting-started-vs-integration-new-project %})
+* [Downloading the Latest Telerik UI for Blazor Versions]({% slug getting-started-vs-integration-latest-version %})

installation/msi.md

@@ -19,6 +19,7 @@ The `MSI` installer provides the following:
 * The [necessary `.nupkg` files]({%slug getting-started/what-you-need%}) so you can setup a [local feed in Visual Studio](#set-up-a-local-nuget-feed-in-visual-studio). You can find them in the `packages` folder under the installation folder.
 * An offline version of our [demos](https://demos.telerik.com/blazor-ui) that you can run and inspect in your IDE. You can find them in the `demos` folder in the installation.
 * A shortcut to our [online demos](https://demos.telerik.com/blazor-ui).
+* Our [Visual Studio Extensions]({%slug getting-started-vs-integration-overview%})