docs(common): add project config to what you need, move it under getting started

marin-bratanov · marin-bratanov · commit 78dc4b70f955 · 2019-06-04T13:00:28.000+03:00
diff --git a/_contentTemplates/common/issues-and-warnings.md b/_contentTemplates/common/issues-and-warnings.md
@@ -2,3 +2,14 @@
 >warning [.NET Core Issue 8385](https://github.com/aspnet/AspNetCore/issues/8385) is preventing the ValueChanged handler from working at the moment. The code below will work as soon as Microsoft release a fix for this problem. Until then, you may get compilation issue due to the handler presence. We strive to follow best practices and future-proof our components, which is why we are using this approach even though it does not work yet.
 #end
 
+
+#mono-linker-issue
+Open the Client `.csproj` file and ensure that the following switch is present. At the moment the IL Linker needs to be disabled because of [an issue in Mono](https://github.com/mono/mono/issues/12917).
+
+    **.csproj**
+    
+        <PropertyGroup>
+            <!-- there may be other elements here -->
+            <BlazorLinkOnBuild>false</BlazorLinkOnBuild>
+        </PropertyGroup>
+#end
diff --git a/getting-started/client-blazor.md b/getting-started/client-blazor.md
@@ -73,14 +73,7 @@ For client-side Blazor, we recommend the usage of `Blazor (ASP.NET Hosted)` proj
             }
         }
 
-1. Open the Client `.csproj` file and ensure that the following switch is present. At the moment the IL Linker needs to be disabled because of [an issue in Mono](https://github.com/mono/mono/issues/12917).
-
-    **.csproj**
-    
-        <PropertyGroup>
-            <!-- there may be other elements here -->
-            <BlazorLinkOnBuild>false</BlazorLinkOnBuild>
-        </PropertyGroup>
+1. @[template](/_contentTemplates/common/issues-and-warnings.md#mono-linker-issue)
 
 
     
diff --git a/getting-started/server-blazor.md b/getting-started/server-blazor.md
@@ -5,7 +5,7 @@ description: First Steps with UI for Blazor Server-side
 slug: getting-started/server-side
 tags: get,started,first,steps,server
 published: true
-position: 1
+position: 2
 ---
 
 # First Steps with Server-side UI for Blazor
diff --git a/getting-started/what-you-need.md b/getting-started/what-you-need.md
@@ -2,16 +2,23 @@
 title: What You Need
 page_title: What You Need
 description: What you need to use the Telerik Blazor components.
-slug: installation/what-you-need
+slug: getting-started/what-you-need
+previous_url: installation//what-you-need
 tags: get,started,installation,what,need,list
 published: True
-position: 0
+position: 3
 ---
 
 # What You Need to Use the Telerik Blazor Components
 
 This article explains the packages you need to use the Telerik UI for Blazor components, and how to get them.
 
+To use the Telerik UI for Blazor, you need:
+
+1. To get the [Telerik Blazor packages](#telerk-specific-packages) in your project
+1. Add the [client assets](#client-assets)
+1. [Set up the project](#project-configuration) to regognize the Telerik components
+
 ## Telerik Specific Packages
 
 The Telerik UI for Blazor component suite requires the following two Telerik-specific NuGet packages:
@@ -51,6 +58,29 @@ To have the Telerik Blazor components look and behave as expected in the browser
     
     For a server-side Blazor scenario, add it to the `~/Pages/_Host.razor` file.
 
+## Project Configuration
+
+To have the framework recognize the Telerik Components, you must register them in the `Startup.cs` file of your Blazor project (if you are using [client-side Blazor](), this is the client web application's file):
+
+````Startup.cs
+namespace MyBlazorAppName
+{
+    public class Startup
+    {
+        public void ConfigureServices(IServiceCollection services)
+        {
+            //more code may be present here
+            services.AddTelerikBlazor();
+        }
+
+        //more code may be present here
+    }
+}
+````
+
+If you are using a client-side Blazor project, 
+@[template](/_contentTemplates/common/issues-and-warnings.md#mono-linker-issue)
+
 ## Before You Continue
 
 Before you continue, make sure you can use Blazor. Read below for more details.
diff --git a/installation/msi.md b/installation/msi.md
@@ -16,7 +16,7 @@ While the most common way to install the Telerik UI for Blazor components is to
 
 The `MSI` installer provides the following:
 
-* The [necessary `.nupkg` files]({%slug installation/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.
+* 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.
 * A shortcut to our [online demos](https://demos.telerik.com/blazor-ui).
 
 
@@ -40,7 +40,7 @@ Once the download completes, run the MSI file and follow the instructions. The d
 
 ## See Also
 
-* [What You Need To Install]({%slug installation/what-you-need%})
+* [What You Need To Install]({%slug getting-started/what-you-need%})
 * [Get Started with Client-side Blazor]({%slug getting-started/client-side%})
 * [Get Started with Server-side Blazor]({%slug getting-started/server-side%})
 
diff --git a/installation/nuget.md b/installation/nuget.md
@@ -12,7 +12,7 @@ position: 1
 
 This article explains how to add the private Telerik NuGet feed to your system. You can use it to obtain the Telerik UI for Blazor components.
 
->tip Once you have the feed working, you can add the Telerik components to your project - both [client-side Blazor](../getting-started/client-blazor) and [server-side Blazor](../getting-started/server-blazor). You can also find more details in the [What You Need](what-you-need) article.
+>tip Once you have the feed working, you can add the Telerik components to your project - both [client-side Blazor](../getting-started/client-blazor) and [server-side Blazor](../getting-started/server-blazor). You can also find more details in the [What You Need](../getting-started/what-you-need) article.
 
 ## Add the Telerik Private NuGet Feed to Your System
 
@@ -64,7 +64,7 @@ NuGet Sources Update -Name "telerik.com" -Source "https://nuget.telerik.com/nuge
 
 ## See Also
 
-* [What You Need To Install]({%slug installation/what-you-need%})
+* [What You Need To Install]({%slug getting-started/what-you-need%})
 * [Get Started with Client-side Blazor]({%slug getting-started/client-side%})
 * [Get Started with Server-side Blazor]({%slug getting-started/server-side%})
 
diff --git a/installation/zip.md b/installation/zip.md
@@ -16,7 +16,7 @@ While the most common way to install the Telerik UI for Blazor components is to
 
 The `ZIP` archive provides the following:
 
-* The [necessary `.nupkg` files]({%slug installation/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 in the archive.
+* 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 in the archive.
 * 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 archive.
 
 
@@ -39,7 +39,7 @@ Once the download completes, open the archive and extract the files to a locatio
 
 ## See Also
 
-* [What You Need To Install]({%slug installation/what-you-need%})
+* [What You Need To Install]({%slug getting-started/what-you-need%})
 * [Get Started with Client-side Blazor]({%slug getting-started/client-side%})
 * [Get Started with Server-side Blazor]({%slug getting-started/server-side%})
 

Original file line number	Diff line number	Diff line change
@@ -73,14 +73,7 @@ For client-side Blazor, we recommend the usage of `Blazor (ASP.NET Hosted)` proj
`73`	`73`	`}`
`74`	`74`	`}`
`75`	`75`
`76`		-1. Open the Client `.csproj` file and ensure that the following switch is present. At the moment the IL Linker needs to be disabled because of [an issue in Mono](https://github.com/mono/mono/issues/12917).
`77`		`-`
`78`		`- .csproj`
`79`		`-`
`80`		`- <PropertyGroup>`
`81`		`- <!-- there may be other elements here -->`
`82`		`- <BlazorLinkOnBuild>false</BlazorLinkOnBuild>`
`83`		`- </PropertyGroup>`
	`76`	`+1. @[template](/_contentTemplates/common/issues-and-warnings.md#mono-linker-issue)`
`84`	`77`
`85`	`78`
`86`	`79`