feat(docs): improve it

Author: jpatovh

docs/features/browser-sync.md

@@ -3,3 +3,5 @@ Create a connection between your desk and your website, using BrowserSync.
 ## Commands
 
 - `gulp serve` - Launch Browsersync server
+
+---

docs/features/css.md

@@ -24,3 +24,5 @@ You can create individual CSS files bundle, using the config:
 - `config.css.lint` - Boolean for if Linting should occur
 - `config.css.sourceComments` - Boolean - Enable comments written in CSS that shows SCSS source. **Don't turn on permanently**, it's useful if SourceMaps aren't working.
 - `config.css.autoPrefixerBrowsers` - Array of [Browsers to Support](https://github.com/ai/browserslist#queries) for Autoprefixer (used by PostCSS).
+
+---

docs/features/drupal-drush.md

@@ -13,5 +13,8 @@ Launch a Drupal command.
 ## Notes
 
 If you want to use it with [Drucker](https://github.com/ovh-ux/drucker), you need to:
+
   - set the `config.drupal.dir` to `./path/to/drucker`
   - set the `config.drupal.command` to `. load-env && drush cc all`
+
+---

docs/features/icons.md

@@ -27,3 +27,5 @@ Or this HTML class:
 - `config.icons.iconName` - Name of the icon (will be the name of the font)
 - `config.icons.classNamePrefix` - Icon class name prefix (default: "icon")
 - `config.icons.templates.css.dest` - The generated SCSS file
+
+---

docs/features/js.md

@@ -1,7 +1,7 @@
 Compiles JS files using Babel. You can optionaly concat, uglify, and add sourcemaps.
 
 !!! note ""
-    It's recommanded to use [Webpack](features/webpack.md) instead.
+    We recommand to use [Webpack](features/webpack.md) instead.
 
 ## Commands
 
@@ -10,3 +10,5 @@ Compiles JS files using Babel. You can optionaly concat, uglify, and add sourcem
 - `gulp validate:js` - Test JS with ESLINT
 - `gulp js:bundleBower` - (optional) compile, uglify, concat bower dependencies (result files will be `bower--*deps*.js`)
 - `gulp watch:bower` - (optional) Watch and compile bower deps
+
+---

docs/features/webpack.md

@@ -15,3 +15,5 @@ You can then configure the JS bundles that you want:
 
 - `gulp webpack` - Launch Webpack compilation
 - `gulp watch:webpack` - Watch and compile
+
+---

docs/index.md

@@ -38,9 +38,6 @@ $ vi gulpfile.yml
 # <set the config that you want, and save it>
 ```
 
-!!! note ""
-    See the [Config](config.yml) section for the documentation about the configuration file.
-
 
 ## Usage
 
@@ -55,3 +52,5 @@ Original project from [p2-theme-core](https://github.com/phase2/p2-theme-core).
 ## License
 
 MIT (original license)
+
+---

docs/troubleshooting.md

@@ -0,0 +1 @@
+---

docs/usage.md

@@ -8,16 +8,18 @@
 
 ## Specifics Commands
 
-You can launch specifics tasks, for example "lint CSS files". In this example, you can use `gulp validate:css`.
+You can launch specifics tasks, for example "lint CSS files": `gulp validate:css`.
 
-All the documentation can be found inside the [Features](features) section.
+All the documentation can be found inside the [Features](features/css.md) section.
 
+---
 
 ### Babel
 
 In order to use Babel, you need to create a `.babelrc` into your project, with the presets that you want installed.
 
 **Example:**
+
 Run: 
 ```bash
 $ npm install --save-dev babel-preset-es2015
@@ -29,11 +31,12 @@ And create a `.babelrc` file:
 }
 ```
 
-### ESLINT
+### ESLint
 
 You need to create a `.eslintrc.js` file, and specify whitch rules that you want (`eslint-config-ovh` is recommanded).
 
 **Example:**
+
 Run: 
 ```bash
 $ npm install --save-dev babel-eslint
@@ -56,11 +59,12 @@ module.exports = {
 };
 ```
 
-### STYLELINT
+### StyleLint
 
 You need to create a `.stylelintrc.js` file, and specify whitch rules that you want (`stylelint-config-ovh` is recommanded).
 
 **Example:**
+
 Run: 
 ```bash
 $ npm install --save-dev stylelint-scss
@@ -74,3 +78,5 @@ module.exports = {
     "extends": "stylelint-config-ovh/configs/scss"
 };
 ```
+
+---