diff --git a/docs/ru/SUMMARY.md b/docs/ru/SUMMARY.md
index 29a1e3b57..406c1aee8 100644
--- a/docs/ru/SUMMARY.md
+++ b/docs/ru/SUMMARY.md
@@ -33,4 +33,4 @@
   - [transformToRequire](options.md#transformtorequire)
   - [buble](options.md#buble)
   - [extractCSS](options.md#extractcss)
-  - [optimizeSSR](options.md#optimizessr)
\ No newline at end of file
+  - [optimizeSSR](options.md#optimizessr)
diff --git a/docs/ru/configurations/advanced.md b/docs/ru/configurations/advanced.md
index c61d81db5..daf4ba9f7 100644
--- a/docs/ru/configurations/advanced.md
+++ b/docs/ru/configurations/advanced.md
@@ -12,8 +12,6 @@
 
 > Опции `preLoaders` и `postLoaders` доступны только в версиях 10.3.0+
 
-### webpack 2.x
-
 ``` js
 module.exports = {
   // другие настройки...
@@ -59,27 +57,4 @@ module.exports = {
 }
 ```
 
-### webpack 1.x
-
-``` js
-// webpack.config.js
-module.exports = {
-  // другие настройки...
-  module: {
-    loaders: [
-      {
-        test: /\.vue$/,
-        loader: 'vue'
-      }
-    ]
-  },
-  // настройки vue-loader
-  vue: {
-    loaders: {
-      // такая же конфигурация правил как и выше
-    }
-  }
-}
-```
-
 Примером использования продвинутой конфигурации может быть например [извлечение CSS из компонентов в отдельный файл](./extract-css.md).
diff --git a/docs/ru/configurations/asset-url.md b/docs/ru/configurations/asset-url.md
index 5fde44942..7c5b0d0a2 100644
--- a/docs/ru/configurations/asset-url.md
+++ b/docs/ru/configurations/asset-url.md
@@ -1,6 +1,6 @@
 # Обработка вложенных URL
 
-По умолчанию `vue-loader` автоматически обрабатывает стили и файлы шаблонов с помощью [css-loader](https://github.com/webpack/css-loader) и компилятора шаблонов Vue. В процессе компиляции, все использованные URL, такие как `<img src="...">`, `background: url(...)` и CSS `@import` будут **обрабатаны как зависимости модуля**.
+По умолчанию `vue-loader` автоматически обрабатывает стили и файлы шаблонов с помощью [css-loader](https://github.com/webpack/css-loader) и компилятора шаблонов Vue. В процессе компиляции, все использованные URL, такие как `<img src="...">`, `background: url(...)` и CSS `@import` будут **обработаны как зависимости модуля**.
 
 Например, `url(./image.png)` будет преобразовано в `require('./image.png')`, а затем
 
diff --git a/docs/ru/configurations/custom-blocks.md b/docs/ru/configurations/custom-blocks.md
index 0da7a6cbc..81afaeba1 100644
--- a/docs/ru/configurations/custom-blocks.md
+++ b/docs/ru/configurations/custom-blocks.md
@@ -41,7 +41,6 @@ comp-a h2 {
 #### webpack.config.js
 
 ``` js
-// webpack 2.x
 var ExtractTextPlugin = require("extract-text-webpack-plugin")
 
 module.exports = {
diff --git a/docs/ru/configurations/extract-css.md b/docs/ru/configurations/extract-css.md
index b185d3b84..2eb503159 100644
--- a/docs/ru/configurations/extract-css.md
+++ b/docs/ru/configurations/extract-css.md
@@ -39,8 +39,6 @@ module.exports = {
 
 Пример конфигурации для извлечения CSS из всех компонентов Vue в отдельный CSS-файл:
 
-### webpack 2.x
-
 ``` js
 // webpack.config.js
 var ExtractTextPlugin = require("extract-text-webpack-plugin")
@@ -68,36 +66,3 @@ module.exports = {
   ]
 }
 ```
-
-### webpack 1.x
-
-``` bash
-npm install extract-text-webpack-plugin --save-dev
-```
-
-``` js
-// webpack.config.js
-var ExtractTextPlugin = require("extract-text-webpack-plugin")
-
-module.exports = {
-  // другие настройки...
-  module: {
-    loaders: [
-      {
-        test: /\.vue$/,
-        loader: 'vue'
-      }
-    ]
-  },
-  vue: {
-    loaders: {
-      css: ExtractTextPlugin.extract("css"),
-      // вы также можете добавить <style lang="less"> или другие языки
-      less: ExtractTextPlugin.extract("css!less")
-    }
-  },
-  plugins: [
-    new ExtractTextPlugin("style.css")
-  ]
-}
-```
diff --git a/docs/ru/features/css-modules.md b/docs/ru/features/css-modules.md
index ed86ca0ae..fda1c1b37 100644
--- a/docs/ru/features/css-modules.md
+++ b/docs/ru/features/css-modules.md
@@ -89,17 +89,6 @@ CSS-модули обрабатываются с помощью [css-loader](htt
 Вы можете использовать в `vue-loader` опцию `cssModules` чтобы добавить дополнительные параметры для `css-loader`:
 
 ``` js
-// webpack 1
-vue: {
-  cssModules: {
-    // другой шаблон для локального имени идентификатора
-    localIdentName: '[path][name]---[local]---[hash:base64:5]',
-    // использование camelCase
-    camelCase: true
-  }
-}
-
-// webpack 2
 module: {
   rules: [
     {
diff --git a/docs/ru/features/postcss.md b/docs/ru/features/postcss.md
index c29d5bda9..e971fc61f 100644
--- a/docs/ru/features/postcss.md
+++ b/docs/ru/features/postcss.md
@@ -27,20 +27,7 @@
 
 В качестве альтернативы, вы можете указать конфигурацию PostCSS специально для `*.vue` файлов с помощью опции `postcss` для `vue-loader`.
 
-Пример использования с webpack 1.x:
-
-``` js
-// webpack.config.js
-module.exports = {
-  // другие настройки...
-  vue: {
-    // использование плагинов PostCSS
-    postcss: [require('postcss-cssnext')()]
-  }
-}
-```
-
-Для webpack 2.x:
+Пример:
 
 ``` js
 // webpack.config.js
diff --git a/docs/ru/options.md b/docs/ru/options.md
index a50b9e6f6..673062aa4 100644
--- a/docs/ru/options.md
+++ b/docs/ru/options.md
@@ -1,10 +1,9 @@
 # Перечень настроек
 
-## Отличия в использовании с webpack 1 & 2
-
-Для webpack 2: настройки можно передавать непосредственно в правилах загрузчиков.
+## Где указывать настройки
 
 ``` js
+// webpack.config.js
 module.exports = {
   // ...
   module: {
@@ -21,20 +20,9 @@ module.exports = {
 }
 ```
 
-Для webpack 1.x: добавить блок `vue` в корень конфигурации webpack:
-
-``` js
-module.exports = {
-  // ...
-  vue: {
-    // настройки vue-loader
-  }
-}
-```
-
 ### loaders
 
-- Тип: `{ [lang: string]: string }`
+- Тип: `{ [lang: string]: string | Object | Array }`
 
   Объект определяющий какие загрузчики webpack переопределят стандартные загрузчики, используемые для обработки секций `*.vue` файлов. Ключ соответствует атрибуту `lang` у секции файла, если таковой был указан. Значения `lang` по умолчанию:
 
@@ -45,7 +33,6 @@ module.exports = {
   Например, чтобы использовать `babel-loader` и `eslint-loader` для обработки всех секций `<script>`:
 
   ``` js
-  // Конфигурация webpack 2.x
   module: {
     rules: [
       {
@@ -61,17 +48,36 @@ module.exports = {
   }
   ```
 
+  Вы также можете использовать синтаксис объектов или массивов (обратите внимание, что параметры должны быть сериализуемы):
+
+  ``` js
+  module: {
+    rules: [
+      {
+        test: /\.vue$/,
+        loader: 'vue-loader',
+        options: {
+          loaders: {
+            js: [
+              { loader: 'cache-loader' },
+              { loader: 'babel-loader', options: { presets: ['env'] } }
+            ]
+          }
+        }
+      }
+    ]
+  }
+  ```
+
 ### preLoaders
 
 - Тип: `{ [lang: string]: string }`
-- поддерживается только в версиях 10.3.0+
 
   Конфигурация подобна как и в `loaders`, но `preLoaders` будут применены к соответствующим секциям перед стандартными загрузчиками. Вы можете использовать это для предварительной обработки секций - например для локализации на этапе сборки.
 
 ### postLoaders
 
 - Тип: `{ [lang: string]: string }`
-- поддерживается только в версиях 10.3.0+
 
   Конфигурация подобна как и в `loaders`, но `postLoaders` применяются после загрузчиков по умолчанию. Вы можете использовать это для пост-обработки языков. Обратите внимание, что тем не менее всё несколько сложнее:
 
@@ -81,7 +87,7 @@ module.exports = {
 
 ### postcss
 
-> Примечание: в версиях 11.0.0+ рекомендуется использовать файл конфигурации PostCSS вместо описания секции. [Использование аналогично как в `postcss-loader`](https://github.com/postcss/postcss-loader#usage).
+> Примечание: рекомендуется использовать файл конфигурации PostCSS, чтобы ваши стили в файлах vue и обычном CSS могли использовать одну и ту же конфигурацию. [Использование аналогично как в `postcss-loader`](https://github.com/postcss/postcss-loader#usage).
 
 - Тип: `Array` или `Function` или `Object`
 
@@ -208,21 +214,6 @@ module.exports = {
   Пример конфигурации:
 
   ``` js
-  // webpack 1
-  vue: {
-    buble: {
-      // enable object spread operator
-      // ПРИМЕЧАНИЕ: вам нужно самостоятельно подключить полифилл для Object.assign!
-      objectAssign: 'Object.assign',
-
-      // отключение удаления `with`
-      transforms: {
-        stripWith: false
-      }
-    }
-  }
-
-  // webpack 2
   module: {
     rules: [
       {
diff --git a/docs/ru/start/setup.md b/docs/ru/start/setup.md
index 241c07bd0..3455d8626 100644
--- a/docs/ru/start/setup.md
+++ b/docs/ru/start/setup.md
@@ -1,13 +1,12 @@
 # Создание проекта
 
-### Использование `vue-cli`
+### Использование `@vue/cli`
 
-Рекомендуем создавать проекты, использующие `vue-loader`, с помощью `vue-cli`:
+Рекомендуем создавать проекты, использующие `vue-loader`, с помощью `@vue/cli`:
 
 ``` bash
-npm install -g vue-cli
-vue init webpack-simple hello-vue
+npm install -g @vue/cli
+vue create hello-vue
 cd hello-vue
-npm install
-npm run dev # можно начинать!
+npm run serve # можно начинать!
 ```
diff --git a/docs/ru/workflow/linting.md b/docs/ru/workflow/linting.md
index ed6757b14..a7b164d8d 100644
--- a/docs/ru/workflow/linting.md
+++ b/docs/ru/workflow/linting.md
@@ -2,72 +2,19 @@
 
 Вы, возможно, гадаете, как же прогонять код в `*.vue` файлах через статические анализаторы, поскольку это не JavaScript. Мы предполагаем, что вы используете [ESLint](https://eslint.org/) (если нет, настоятельно рекомендуем!).
 
-Вам также понадобится [eslint-html-plugin](https://github.com/BenoitZugmeyer/eslint-plugin-html) с поддержкой извлечения и анализа JavaScript в `*.vue` файлах.
+Вам также понадобится официальный [eslint-plugin-vue](https://github.com/vuejs/eslint-plugin-vue), который поддерживает анализа шаблона и скриптов в `*.vue` файлах.
 
-Убедитесь в том, что вы добавили плагин в конфигурацию ESLint:
+Убедитесь, что используете поставляемую с плагином конфигурацию в вашей конфигурации ESLint:
 
 ``` json
-"plugins": [
-  "html"
-]
-```
-
-Затем в командной строке:
-
-``` bash
-eslint --ext js,vue MyComponent.vue
-```
-
-Другой вариант – использовать [eslint-loader](https://github.com/MoOx/eslint-loader), который будет автоматически анализировать `*.vue` файлы после сохранения во время разработки:
-
-``` bash
-npm install eslint eslint-loader --save-dev
-```
-
-``` js
-// webpack.config.js
-module.exports = {
-  // ... прочие опции
-  module: {
-    loaders: [
-      {
-        test: /\.vue$/,
-        loader: 'vue!eslint'
-      }
-    ]
-  }
+{
+  "extends": [
+    "plugin:vue/essential"
+  ]
 }
 ```
 
-Обратите внимание, что загрузчики webpack применяются **справа-налево**. Убедитесь, что `eslint` прописан перед `vue`, чтобы код сначала проходил через анализатор, а затем компилировался.
-
-Стоит упомянуть об использовании сторонних `*.vue` компонентов, поставляемых в NPM пакетах. В таком случае нам нужно воспользоваться `vue-loader`? чтобы подключить сторонние компоненты, но не анализировать их. Мы можем вынести анализ в [предзагрузчики](https://webpack.github.io/docs/loaders.html#loader-order) webpack:
-
-``` js
-// webpack.config.js
-module.exports = {
-  // ... прочие опции
-  module: {
-    // анализировать только локальные *.vue файлы
-    preLoaders: [
-      {
-        test: /\.vue$/,
-        loader: 'eslint',
-        exclude: /node_modules/
-      }
-    ],
-    // но использовать vue-loader для всех *.vue файлов
-    loaders: [
-      {
-        test: /\.vue$/,
-        loader: 'vue'
-      }
-    ]
-  }
-}
-```
-
-Для webpack 2.x:
+Убедитесь, что он применяется как предварительный загрузчик:
 
 ``` js
 // webpack.config.js
@@ -75,17 +22,11 @@ module.exports = {
   // ... прочие опции
   module: {
     rules: [
-      // анализировать только локальные *.vue файлы
       {
         enforce: 'pre',
-        test: /\.vue$/,
+        test: /\.(js|vue)$/,
         loader: 'eslint-loader',
         exclude: /node_modules/
-      },
-      // но использовать vue-loader для всех *.vue файлов
-      {
-        test: /\.vue$/,
-        loader: 'vue-loader'
       }
     ]
   }
diff --git a/docs/ru/workflow/production.md b/docs/ru/workflow/production.md
index a8f392d14..0f872dc2f 100644
--- a/docs/ru/workflow/production.md
+++ b/docs/ru/workflow/production.md
@@ -19,18 +19,12 @@ module.exports = {
       }
     }),
     // минифицируем, устраняя весь ненужный код
-    new webpack.optimize.UglifyJsPlugin({
-      compress: {
-        warnings: false
-      }
-    }),
-    // только для webpack 1 – оптимизируем идентификаторы модулей по числу использований
-    new webpack.optimize.OccurrenceOrderPlugin()
+    new webpack.optimize.UglifyJsPlugin()
   ]
 }
 ```
 
-Очевидно, нам ни к чему использовать эту конфигурацию во время разработки, для этого есть несколько вариантов:
+Нам ни к чему использовать эту конфигурацию во время разработки, для этого есть несколько вариантов:
 
 1. Динамически собирать объект конфигурации на основе переменных окружения;
 
diff --git a/docs/ru/workflow/testing.md b/docs/ru/workflow/testing.md
index 17594b64f..fcce0bdb1 100644
--- a/docs/ru/workflow/testing.md
+++ b/docs/ru/workflow/testing.md
@@ -1,102 +1,5 @@
 # Тестирование
-# Testing
 
-> [Шаблон webpack vue-cli](https://github.com/vuejs-templates/webpack) предлагает вам готовые решения для модульного и e2e-тестирования.
+- [@vue/cli](https://github.com/vuejs/vue-cli) предлагает вам готовые решения для модульного и e2e-тестирования.
 
-Тестируя `*.vue` файлы, мы не можем использовать обычные тестовые движки для CommonJS, поскольку они не знают, как обрабатывать `*.vue` файлы. Вместо этого мы снова воспользуемся webpack + vue-loader для сборки наших тестов. Мы рекомендуем использовать сочетание [Karma](https://karma-runner.github.io/0.13/index.html) и [karma-webpack](https://github.com/webpack/karma-webpack).
-
-Karma – это тестовый движок, который запускает браузеры и прогоняет тесты за вас. Вы можете выбрать, в каких браузерах выполнять тесты и какой тестовый фреймворк использовать (например, Mocha или Jasmin). Вот пример конфигурации Karma для тестирования в [PhantomJS](http://phantomjs.org/) с помощью фреймворка [Jasmine](https://jasmine.github.io/edge/introduction.html):
-
-``` bash
-npm install\
-  karma karma-webpack\
-  karma-jasmine jasmine-core\
-  karma-phantomjs-launcher phantomjs-prebuilt\
-  --save-dev
-```
-
-``` js
-// мы можем воспользоваться тем же файлом конфигурации,
-// однако, не забудьте удалить оригинальную точку входа,
-// поскольку во время тестирования нам она не нужна
-var webpackConfig = require('./webpack.config.js')
-delete webpackConfig.entry
-
-// karma.conf.js
-module.exports = function (config) {
-  config.set({
-    browsers: ['PhantomJS'],
-    frameworks: ['jasmine'],
-    // это файл точки входа для всех наших тестов.
-    files: ['test/index.js'],
-    // передаем файл точки входа в webpack для сборки.
-    preprocessors: {
-      'test/index.js': ['webpack']
-    },
-    // используем конфигурацию webpack
-    webpack: webpackConfig,
-    // избегаем стены бесполезного текста
-    webpackMiddleware: {
-      noInfo: true
-    },
-    singleRun: true
-  })
-}
-```
-
-И для файла точки входа `test/index.js`:
-
-``` js
-// test/index.js
-// подтягиваем все файлы тестов, используя специальную возможность webpack
-// https://webpack.github.io/docs/context.html#require-context
-var testsContext = require.context('.', true, /\.spec$/)
-testsContext.keys().forEach(testsContext)
-```
-
-Эта точка входа просто подтягивает все другие файлы, названия которых заканчиваются на `.spec.js` в ту же папку. Теперь мы наконец-то можем написать немного тестов:
-
-``` js
-// test/component-a.spec.js
-var Vue = require('vue')
-var ComponentA = require('../../src/components/a.vue')
-
-describe('a.vue', function () {
-
-  // проверяем свойства JavaScript-объекта
-  it('should have correct message', function () {
-    expect(ComponentA.data().msg).toBe('Привет от компонента A!')
-  })
-
-  // проверяем результаты рендеринга, вызывая рендер компонента
-  it('should render correct message', function () {
-    var vm = new Vue({
-      template: '<div><test></test></div>',
-      components: {
-        'test': ComponentA
-      }
-    }).$mount()
-    expect(vm.$el.querySelector('h2.red').textContent).toBe('Привет от компонента A!')
-  })
-})
-```
-
-Чтобы запустить тесты, добавьте следующий NPM скрипт:
-
-``` js
-// package.json
-...
-"scripts": {
-  ...
-  "test": "karma start karma.conf.js"
-}
-...
-```
-
-Наконец, запускаем:
-
-``` bash
-npm test
-```
-
-Опять же, [шаблон webpack vue-cli](https://github.com/vuejs-templates/webpack) содержит готовый рабочий пример с тестами.
+- Если вы заинтересованы в ручной настройке модульного тестирования для `*.vue` файлов, ознакомьтесь с [документацией для `@vue/test-utils`](https://vue-test-utils.vuejs.org/ru/).
\ No newline at end of file