docs: update (#406)

Author: alexander-akait

README.md

@@ -281,7 +281,7 @@ module.exports = {
 Type: `Boolean`
 Default: `true`
 
-Enables/Disables the default Webpack importer.
+Enables/Disables the default `webpack` importer.
 
 This can improve performance in some cases. Use it with caution because aliases and `@import` at-rules starting with `~` will not work.
 
@@ -418,21 +418,31 @@ Usually, it's recommended to extract the style sheets into a dedicated file in p
 
 ### Imports
 
-Starting with `less-loader` 4, you can now choose between Less' builtin resolver and webpack's resolver. By default, webpack's resolver is used.
+First we try to use built-in `less` resolve logic, then `webpack` resolve logic (aliases and `~`).
 
-#### webpack resolver
+#### Webpack Resolver
 
-webpack provides an [advanced mechanism to resolve files](https://webpack.js.org/configuration/resolve/). The `less-loader` applies a Less plugin that passes all queries to the webpack resolver. Thus you can import your Less modules from `node_modules`. Just prepend them with a `~` which tells webpack to look up the [`modules`](https://webpack.js.org/configuration/resolve/#resolve-modules).
+`webpack` provides an [advanced mechanism to resolve files](https://webpack.js.org/configuration/resolve/).
+`less-loader` applies a Less plugin that passes all queries to the webpack resolver if `less` could not resolve `@import`.
+Thus you can import your Less modules from `node_modules`.
+
+```css
+@import "bootstrap/less/bootstrap";
+```
+
+Using `~` is deprecated and can be removed from your code (**we recommend it**), but we still support it for historical reasons.
+Why you can removed it? The loader will first try to resolve `@import` as relative, if it cannot be resolved, the loader will try to resolve `@import` inside [`node_modules`](https://webpack.js.org/configuration/resolve/#resolve-modules).
+Just prepend them with a `~` which tells webpack to look up the [`modules`](https://webpack.js.org/configuration/resolve/#resolve-modules).
 
 ```css
 @import "~bootstrap/less/bootstrap";
 ```
 
 It's important to only prepend it with `~`, because `~/` resolves to the home-directory. webpack needs to distinguish between `bootstrap` and `~bootstrap`, because CSS and Less files have no special syntax for importing relative files. Writing `@import "file"` is the same as `@import "./file";`
 
-#### Less resolver
+#### Less Resolver
 
-If you specify the `paths` option, modules will be searched in the given `paths`. This is Less' default behavior. `paths` should be an array with absolute paths:
+If you specify the `paths` option, modules will be searched in the given `paths`. This is `less` default behavior. `paths` should be an array with absolute paths:
 
 **webpack.config.js**