docs(common): clarifications on wasm support, distribution and linker issues

Author: marin-bratanov

_contentTemplates/common/get-started.md

@@ -29,7 +29,7 @@
 
 #after-you-run-vanilla
 
->tip Make sure that you have {{site.supportedFrameworkVersion}} and [Visual Studio 2019 Preview](https://visualstudio.microsoft.com/vs/preview/) installed.
+>tip Make sure that you have [{{site.supportedFrameworkVersion}}](https://dotnet.microsoft.com/download/dotnet-core/3.1) and [Visual Studio 2019](https://visualstudio.microsoft.com/vs/) installed.
 >
 > The latest version of Telerik UI for Blazor is `{{site.uiForBlazorLatestVersion}}` and it supports `{{site.supportedFrameworkVersion}}`.
 

getting-started/client-blazor.md

@@ -18,7 +18,11 @@ This article explains how to get the Telerik UI for Blazor components in your **
     * [Add to an Existing Project](#add-to-existing-project)
 1. [Add a Telerik Component to a View](#add-a-telerik-component-to-a-view)
 
->note You can follow the progress of a WASM flavor supported officially by Microsoft in the following links: [Milestone](https://github.com/aspnet/AspNetCore/milestone/58) and [Project](https://github.com/orgs/aspnet/projects/32). You can still work on client-side Blazor apps in the meantime, but there may be changes in the framework.
+
+>caution The latest version of Telerik UI for Blazor is `{{site.uiForBlazorLatestVersion}}` and it supports `WASM .NET Core 3.1 Preview 3` and not the latest `WASM .NET Core 3.1 Preview 4` because of severe issues in the Linker. You can read more about this in the [Framework Versions Support]({%slug framework-versions-support%}) article.
+>
+>To run a WASM project with the Telerik components, keep the WASM NuGet package references pointing to the `3.1.0-preview3.19555.2` version.
+
 
 @[template](/_contentTemplates/common/get-started.md#add-latest-ms-bits-client-side-link)
 

upgrade/framework-versions.md

@@ -12,17 +12,35 @@ position: 5
 
 This article lists the .NET Core versions supported by the UI for Blazor suite, and which versions of the Telerik UI for Blazor work under which framework versions.
 
->note We currently support only the latest available version of UI for Blazor (**{{site.uiForBlazorLatestVersion}}**) and the .NET Core 3 SDK (**{{site.supportedFrameworkVersion}}**) on the [Server-side](https://docs.telerik.com/blazor-ui/getting-started/server-blazor) flavor. On the [WebAssembly](https://docs.telerik.com/blazor-ui/getting-started/client-blazor) flavor, `.NET Core 3.1 preview 3` is supported, because in the `.NET Core 3.1 preview 4 of WASM`, the linker breaks extension methods that our components require.
+Telerik supports only the latest available version of UI for Blazor (**{{site.uiForBlazorLatestVersion}}**).
+
+## Serve-side Blazor
+
+>caption Telerik UI for Blazor versions per framework version for the server-side flavor
 
 
 | .NET version              | Telerik UI for Blazor version |
 |---------------------------|-------------------------------|
-| .NET Core 3.1             | 2.5.0                         |
+| .NET Core 3.1 RTM         | 2.5.0                         |
 | .NET Core 3.1 preview 3   | 2.4.0                         |
 | .NET Core 3.1 preview 2   | 2.3.0                         |
 | .NET Core 3.1 preview 1   | 2.2.0, 2.2.1                  |
 | .NET Core 3.0 RTM         | 2.1.0, 2.1.1                  |
 
+## Client-side Blazor
+
+The client-side (WASM) flavor of Blazor is not part of the .NET Core 3.1 framework. It is not supported by Microsoft yet and it ships as preview NuGet packages that you reference in your projects. While the release dates and numbers of the WASM flavor often match with the .NET Core versions and releases, they are separate products at the moment.
+
+>caption Telerik UI for Blazor versions per WASM Preview version
+
+| WASM Preview version      | Telerik UI for Blazor version |
+|---------------------------|-------------------------------|
+| .NET Core 3.1 preview 4 (release date matches .NET Core 3.1 GA)   | N/A - there are major issues in the Linker that prevent our code from working in this version.                         |
+| .NET Core 3.1 preview 3   | 2.4.0, 2.5.0                  |
+| .NET Core 3.1 preview 2   | 2.3.0                         |
+| .NET Core 3.1 preview 1   | 2.2.0, 2.2.1                  |
+| .NET Core 3.0 RTM         | 2.1.0, 2.1.1                  |
+
 
 ## See Also