Added initial bundling minficiation document

docs/AspNetCore/Bundling-Minification.md

@@ -1,3 +1,119 @@
 ## ASP.NET Core MVC Bundling & Minification
 
-TODO
+There are many ways of bundling & minification for client side resources (JavaScript and CSS files). Most common ways are:
+
+* Using the [Bundler & Minifier](https://marketplace.visualstudio.com/items?itemName=MadsKristensen.BundlerMinifier) Visual Studio extension or the [nuget package](https://www.nuget.org/packages/BuildBundlerMinifier/).
+* Using [Gulp](https://gulpjs.com/)/[Grunt](https://gruntjs.com/) task managers and their plugins.
+
+ABP offers a simpler, dynamic, powerful, modular and built-in way.
+
+### Volo.Abp.AspNetCore.Mvc.UI.Bundling Package
+
+> This package is already installed by default with the startup templates. So, most of the time, you don't need to install it manually.
+
+Install the Volo.Abp.AspNetCore.Mvc.UI.Bundling nuget package to your project:
+
+````
+install-package Volo.Abp.AspNetCore.Mvc.UI.Bundling
+````
+
+Then you can add **AbpLocalizationModule** dependency to your module:
+
+````C#
+using Volo.Abp.Modularity;
+using Volo.Abp.AspNetCore.Mvc.UI.Bundling;
+
+namespace MyCompany.MyProject
+{
+    [DependsOn(typeof(AbpAspNetCoreMvcUiBundlingModule))]
+    public class MyWebModule : AbpModule
+    {
+        //...
+    }
+}
+````
+
+### Using The Razor Bundling Tag Helpers
+
+The simplest way of creating a bundle is to use `abp-script-bundle` or `abp-style-bundle` tag helpers. Example:
+
+````html
+<abp-style-bundle name="MyGlobalBundle">
+    <abp-bundle-file src="/libs/bootstrap/css/bootstrap.css" />
+    <abp-bundle-file src="/libs/font-awesome/css/font-awesome.css" />
+    <abp-bundle-file src="/libs/toastr/toastr.css" />
+    <abp-bundle-file src="/styles/my-global-style.css" />
+</abp-style-bundle>
+````
+
+This bundle defines a style bundle with a **unique name** *MyGlobalBundle*. It's very easy to *understand* how to use it. Let's see how it *works*:
+
+* ABP creates the bundle as **lazy** from the provided files when it's **first requested**. For the subsequent calls, it's returned from the **cache**. That means if you conditionally add files to the bundle, it's executed only once and any change of the condition will not effect the bundle for the next requests.
+* ABP adds bundle files **individually** to the page for the `development` environment. It automatically bundles & minifies for the other environments (`staging`, `production`...).
+
+#### Importing The Bundling Tag Helpers
+
+> This is already imported by default with the startup templates. So, most of the time, you don't need to add it manually.
+
+In order to use bundle tag helpers, you need to add it into your `_ViewImports.cshtml` file or into your page:
+
+````
+@addTagHelper *, Volo.Abp.AspNetCore.Mvc.UI.Bundling
+````
+
+#### Unnamed & Dynamic Bundles
+
+The `name` is **optional** for the razor bundle tag helpers. If you don't define a name, it's automatically **calculated** based on the used bundle files (they are **concatenated** and **hashed**). That means you may have **dynamic bundles** if you define bundle files inside @if statements. Example:
+
+````html
+<abp-style-bundle>
+    <abp-bundle-file src="/libs/bootstrap/css/bootstrap.css" />
+    <abp-bundle-file src="/libs/font-awesome/css/font-awesome.css" />
+    <abp-bundle-file src="/libs/toastr/toastr.css" />
+    @if (ViewBag.IncludeCustomStyles != false)
+    {
+        <abp-bundle-file src="/styles/my-global-style.css" />
+    }
+</abp-style-bundle>
+````
+
+This will potentially create two different bundles (one incudes the `my-global-style.css` and other does not).
+
+> It's always suggested to use a `name` for the bundle unless you need to the dynamic bundling feature. Providing a name is more performant since it does not need to get bundle files and calculate a dynamic name.
+
+### Using Bundling Options
+
+If you need to use same bundle in **multiple pages** or want to use some more **powerful features**, you can configure bundles **by code** in your [module](../Module-Development-Basics.md) class. Example usage:
+
+````C#
+[DependsOn(typeof(AbpAspNetCoreMvcUiBundlingModule))]
+public class MyWebModule : AbpModule
+{
+    public override void ConfigureServices(IServiceCollection services)
+    {
+        services.Configure<BundlingOptions>(options =>
+        {
+            options
+                .ScriptBundles
+                .Add("MyGlobalBundle")
+                .AddFiles(
+                    "/libs/jquery/jquery.js",
+                    "/libs/bootstrap/js/bootstrap.js",
+                    "/libs/toastr/toastr.min.js",
+                    "/scripts/my-global-scripts.css"
+                );
+        });
+    }
+}
+````
+
+> You can use the same name (*MyGlobalBundle* here) for a script & style bundle since they are added to different collections (`ScriptBundles` and `StyleBundles`).
+
+After defining such a bundle, it can be included into a page using the same tag helpers defined above. Example:
+
+````html
+<abp-script-bundle name="MyGlobalBundle" />
+````
+
+This time, no file defined in the tag helper definition because the bundle files are defined by the code.
+