您 -> 你 & 统一为：本指南继续沿用[xxx](/guides/xxx)中的代码示例

src/content/api/cli.md

@@ -230,6 +230,7 @@ webpack.js index=./src/index.js index2=./src/index2.js --output-path='./dist' --
 `--optimize-max-chunks`     | 限制 chunk 的数量 | [LimitChunkCountPlugin](/plugins/limit-chunk-count-plugin)
 `--optimize-min-chunk-size` | 限制 chunk 的最小体积               | [MinChunkSizePlugin](/plugins/min-chunk-size-plugin)
 `--optimize-minimize`       | 压缩混淆 javascript，并且把 loader 设置为 minimizing | [UglifyJsPlugin](/plugins/uglifyjs-webpack-plugin/) & [LoaderOptionsPlugin](/plugins/loader-options-plugin/)
+`--concatenate-modules` | 连结 ES 模块，尽可能移除模块包装容器(module wrappers) | [ModuleConcatenationPlugin](/plugins/module-concatenation-plugin/)
 
 
 ### Resolve 配置
@@ -294,7 +295,7 @@ webpack.js index=./src/index.js index2=./src/index2.js --output-path='./dist' --
 简写 | 含义
 ---------|----------------------------
 -d       | `--debug --devtool cheap-module-eval-source-map --output-pathinfo`
--p       | `--optimize-minimize --define process.env.NODE_ENV="production"`, see [building for production](/guides/production)
+-p       | `--optimize-minimize --define process.env.NODE_ENV="production" --concatenate-modules`, see [building for production](/guides/production)
 
 
 ### Profiling

src/content/api/loaders.md

@@ -261,7 +261,7 @@ T> loader 最初被设计为可以同时当 Babel transform 用。如果你编
 ### `this.emitWarning`
 
 ```typescript
-emitWarning(message: string)
+emitWarning(warning: Error)
 ```
 
 发出一个警告。
@@ -270,7 +270,7 @@ emitWarning(message: string)
 ### `this.emitError`
 
 ```typescript
-emitError(message: string)
+emitError(error: Error)
 ```
 
 发出一个错误。

src/content/concepts/index.md

@@ -1,47 +1,53 @@
 ---
-title: 核心概念
+title: 概念
 sort: 1
 contributors:
   - TheLarkInn
   - jhnns
   - grgur
   - johnstew
   - jimrfenner
+  - TheDutchCoder
 ---
 
-*webpack* 是一个现代 JavaScript 应用程序的_模块打包器(module bundler)_。当 webpack 处理应用程序时，它会递归地构建一个_依赖关系图(dependency graph)_，其中包含应用程序需要的每个模块，然后将所有这些模块打包成少量的 _bundle_ - 通常只有一个，由浏览器加载。
+从其提供的核心功能来看，*webpack* 是一个现代 JavaScript 应用程序的_模块打包器(module bundler)_。当 webpack 处理应用程序时，它会递归地构建一个_依赖关系图(dependency graph)_，其中包含应用程序需要的每个模块，然后将所有这些模块打包成一个或多个 _bundle_。
 
-它是[高度可配置的](/configuration)，但是，在开始前你需要先理解**四个核心概念**：入口(entry)、输出(output)、loader、插件(plugins)。
+它是[高度可配置的](/configuration)，但是，在开始前你需要先理解四个**核心概念**：
+
+- 入口(entry)
+- 输出(output)
+- loader
+- 插件(plugins)
 
 本文档旨在给出这些概念的**高度**概述，同时提供具体概念的详尽相关用例。
 
 
-## 入口(Entry)
+## 入口(entry)
 
-webpack 创建应用程序所有依赖的关系图(dependency graph)。图的起点被称之为_入口起点(entry point)_。_入口起点_告诉 webpack _从哪里开始_，并根据依赖关系图确定_需要打包的内容_。可以将应用程序的_入口起点_认为是**根上下文(contextual root)** 或 **app 第一个启动文件**。
+**入口起点(entry point)**指示 webpack 应该使用哪个模块，来作为构建其内部*依赖图*的开始。进入入口起点后，webpack 会找出有哪些模块和库是入口起点（直接和间接）依赖的。
 
-在 webpack 中，我们使用 [webpack 配置对象(webpack configuration object)](/configuration) 中的 `entry` 属性来定义_入口_。
+然后，处理每个依赖，并将其输出到名为 *bundles* 的文件中，我们将在下一章节详细讨论这个过程。
 
-接下来我们看一个最简单的例子：
+可以通过在 [webpack 配置](/configuration)中配置 `entry` 属性，来指定一个入口起点（或多个入口起点）。
 
-**webpack.config.js**
+接下来我们看一个 `entry` 配置的最简单例子：
 
-```javascript
+__webpack.config.js__
+
+``` js
 module.exports = {
   entry: './path/to/my/entry/file.js'
 };
 ```
 
-根据不同应用程序的需要，声明 `entry` 属性有多种方式。
+T> 根据应用程序的特定需求，可以以多种方式配置 `entry` 属性。从[入口起点](/concepts/entry-points)章节可以了解更多信息。
 
-[了解更多！](/concepts/entry-points)
 
+## 出口(output)
 
-## 出口(Output)
+**output** 属性告诉 webpack 在哪里输出它所创建的 *bundles*，以及如何命名这些文件。你可以通过在配置中指定一个 `output` 字段，来配置这些处理过程：
 
-将所有的资源(assets)归拢在一起后，还需要告诉 webpack **在哪里**打包应用程序。webpack 的 `output` 属性描述了**如何处理归拢在一起的代码**(bundled code)。
-
-**webpack.config.js**
+__webpack.config.js__
 
 ```javascript
 const path = require('path');
@@ -59,20 +65,18 @@ module.exports = {
 
 T> 你可能看到项目**生成(emitted 或 emit)**贯穿我们整个文档和[插件 API](/api/plugins)。它是“生产(produced)”或“排放(discharged)”的特殊术语。
 
- `output` 属性还有[更多可配置的特性](/configuration/output)，但让我们花一些时间先了解一些 `output` 属性最常见的用例。
-
-[了解更多！](/concepts/output)
+`output` 属性还有[更多可配置的特性](/configuration/output)，如果你想要了解更多关于 `output` 属性的概念，你可以通过[阅读核心章节]more in the concepts section](/concepts/output)来了解更多。
 
 
-## Loader
+## loader
 
-webpack 的目标是，让 **webpack** 聚焦于项目中的所有资源(asset)，而浏览器不需要关注考虑这些（明确的说，这并不意味着所有资源(asset)都必须打包在一起）。webpack 把[每个文件(.css, .html, .scss, .jpg, etc.) 都作为模块](/concepts/modules)处理。然而 webpack 自身**只理解 JavaScript**。
+*loader* 能够让 webpack 额外去处理那些非 JavaScript 文件（webpack 自身只理解 JavaScript）。loader 可以将所有类型的文件转换为有效的[模块](/concepts/modules)，然后再利用 webpack 的打包能力，对它们进行处理。
 
-**webpack loader 在文件被添加到依赖图中时，_其转换为模块_。**
+本质上，webpack loader 将所有类型的文件，转换为应用程序的依赖图可以直接引用的模块。
 
 在更高层面，在 webpack 的配置中 **loader** 有两个目标。
 
-1. 识别出(identify)应该被对应的 loader 进行转换(transform)的那些文件。(`test` 属性)
+1. 识别出应该被对应的 loader 进行转换的那些文件。(使用 `test` 属性)
 2. 转换这些文件，从而使其能够被添加到依赖图中（并且最终添加到 bundle 中）(`use` 属性)
 
 **webpack.config.js**
@@ -107,17 +111,17 @@ loader 还有更多我们尚未提到的具体配置属性。
 [了解更多！](/concepts/loaders)
 
 
-## 插件(Plugins)
+## 插件(plugins)
 
-然而由于 loader 仅在每个文件的基础上执行转换，而 `插件(plugins)` 更常用于（但不限于）在打包模块的 “compilation” 和 “chunk” 生命周期执行操作和自定义功能[（查看更多）](/concepts/plugins)。webpack 的插件系统[极其强大和可定制化](/api/plugins)。
+loader 习惯用于转换某些类型的模块，而插件则可以用于执行范围更广的任务。插件的范围包括，从打包优化和压缩，一直到重新定义环境中的变量。[插件接口](/api/plugins)功能极其强大，可以用来处理各种各样的任务。
 
-想要使用一个插件，你只需要 `require()` 它，然后把它添加到 `plugins` 数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件，这时需要通过使用 `new` 来创建它的一个实例。
+想要使用一个插件，你只需要 `require()` 它，然后把它添加到 `plugins` 数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件，这时需要通过使用 `new` 操作符来创建它的一个实例。
 
 **webpack.config.js**
 
 ```javascript
-const HtmlWebpackPlugin = require('html-webpack-plugin'); //installed via npm
-const webpack = require('webpack'); //to access built-in plugins
+const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
+const webpack = require('webpack'); // 用于访问内置插件
 const path = require('path');
 
 const config = {

src/content/guides/hot-module-replacement.md

@@ -162,6 +162,8 @@ server.listen(5000, 'localhost', () => {
 });
 ```
 
+T> If you're [using `webpack-dev-middleware`](/guides/development#using-webpack-dev-middleware), check out the [`webpack-hot-middleware`](https://github.com/glenjamin/webpack-hot-middleware) package to enable HMR on your custom dev server.
+
 
 ## 问题
 

src/content/guides/production.md

@@ -15,6 +15,7 @@ contributors:
   - xgqfrms
   - kelset
   - xgirma
+  - iamakulov
 ---
 
 在本指南中，我们将深入一些最佳实践，并且使用工具，将网站或应用程序构建到生产环境中。
@@ -199,7 +200,8 @@ __webpack.prod.js__
     plugins: [
       new UglifyJSPlugin({
         sourceMap: true
-      }),
+-     })
++     }),
 +     new webpack.DefinePlugin({
 +       'process.env': {
 +         'NODE_ENV': JSON.stringify('production')
@@ -236,10 +238,48 @@ __src/index.js__
   document.body.appendChild(component());
 ```
 
+## Module Concatenation
+
+By default, webpack wraps each module into a function. Wrapping helps to isolate them but brings additional overhead. You can try reducing this overhead by enabling the [`ModuleConcatenationPlugin`](/plugins/module-concatenation-plugin), which, where possible, merges multiple modules in a single module wrapper:
+
+__webpack.prod.js__
+
+```diff
+  const webpack = require('webpack');
+  const merge = require('webpack-merge');
+  const UglifyJSPlugin = require('uglifyjs-webpack-plugin');
+  const common = require('./webpack.common.js');
+
+  module.exports = merge(common, {
+    devtool: 'cheap-module-source-map',
+    plugins: [
+      new UglifyJSPlugin({
+        sourceMap: true
+      }),
+      new webpack.DefinePlugin({
+        'process.env': {
+          'NODE_ENV': JSON.stringify('production')
+        }
+-     })
++     }),
++     new webpack.optimize.ModuleConcatenationPlugin()
+    ]
+  })
+```
+
+Read more about module concatenation [in the plugin docs](/plugins/module-concatenation-plugin).
+
 
 ## CLI 替代选项
 
-以上描述也可以通过命令行实现。例如，`--optimize-minimize` 标记将在后台引用 `UglifyJSPlugin`。和以上描述的 `DefinePlugin` 实例相同，`--define process.env.NODE_ENV="'production'"` 也会做同样的事情。并且，`webpack -p` 将自动地调用上述这些标记，从而调用需要引入的插件。
+
+以上描述也可以通过命令行实现：
+
+- `--optimize-minimize` 标记将在后台引用 `UglifyJSPlugin`；
+- `--define process.env.NODE_ENV="'production'"` 将复制上面的 `DefinePlugin` 实例；
+- `--concatenate-modules` 将启用 `ModuleConcatenationPlugin`.
+
+并且，`webpack -p` 将自动地调用上述这些标记，从而调用需要引入的插件。
 
 这些简便方式虽然都很不错，但是我们通常建议只使用配置方式，因为在这两种场景中下，配置方式能够更好地帮助你了解自己正在做的事情。配置方式还可以让你更方便地控制这两个插件中的其他选项。
 

src/content/guides/shimming.md

@@ -6,6 +6,7 @@ contributors:
   - jhnns
   - simon04
   - jeremenichelli
+  - svyandun
 related:
   - title: Reward modern browser users script
     url: https://hackernoon.com/10-things-i-learned-making-the-fastest-site-in-the-world-18a0e1cdf4a7#c665
@@ -65,6 +66,7 @@ __webpack.config.js__
 
 ``` diff
   const path = require('path');
++ const webpack = require('webpack');
 
   module.exports = {
     entry: './src/index.js',
@@ -75,7 +77,7 @@ __webpack.config.js__
 +   },
 +   plugins: [
 +     new webpack.ProvidePlugin({
-+       lodash: 'lodash'
++       _: 'lodash'
 +     })
 +   ]
   };
@@ -112,6 +114,7 @@ __webpack.config.js__
 
 ``` diff
   const path = require('path');
+  const webpack = require('webpack');
 
   module.exports = {
     entry: './src/index.js',
@@ -121,7 +124,7 @@ __webpack.config.js__
     },
     plugins: [
       new webpack.ProvidePlugin({
--       lodash: 'lodash'
+-       _: 'lodash'
 +       join: ['lodash', 'join']
       })
     ]
@@ -156,6 +159,7 @@ __webpack.config.js__
 
 ``` diff
   const path = require('path');
+  const webpack = require('webpack');
 
   module.exports = {
     entry: './src/index.js',
@@ -213,6 +217,7 @@ __webpack.config.js__
 
 ``` diff
   const path = require('path');
+  const webpack = require('webpack');
 
   module.exports = {
     entry: './src/index.js',
@@ -323,6 +328,7 @@ __webpack.config.js__
 
 ``` diff
   const path = require('path');
+  const webpack = require('webpack');
 
   module.exports = {
 -   entry: './src/index.js',

src/content/guides/typescript.md

@@ -78,7 +78,7 @@ module.exports = {
     ]
   },
   resolve: {
-    extensions: [ ".tsx", ".ts", ".js" ]
+    extensions: [ '.tsx', '.ts', '.js' ]
   },
   output: {
     filename: 'bundle.js',
@@ -139,7 +139,7 @@ __webpack.config.js__
       ]
     },
     resolve: {
-      extensions: [ ".tsx", ".ts", ".js" ]
+      extensions: [ '.tsx', '.ts', '.js' ]
     },
     output: {
       filename: 'bundle.js',

src/content/plugins/module-concatenation-plugin.md

@@ -15,7 +15,9 @@ related:
 new webpack.optimize.ModuleConcatenationPlugin()
 ```
 
-> 由于实现 ECMAScript 模块语法，作用域提升(Scope Hoisting)这个特定于此语法的功能才成为可能。`webpack` 可能会根据你正在使用的模块类型和[其他的情况](https://medium.com/webpack/webpack-freelancing-log-book-week-5-7-4764be3266f5)，回退到普通打包。
+> 这种连结行为被称为“作用域提升(scope hoisting)”。
+>
+> 由于实现 ECMAScript 模块语法，作用域提升(scope hoisting)这个特定于此语法的功能才成为可能。`webpack` 可能会根据你正在使用的模块类型和[其他的情况](https://medium.com/webpack/webpack-freelancing-log-book-week-5-7-4764be3266f5)，回退到普通打包。
 
 
 ## 绑定失败的优化[Optimization Bailouts]
@@ -72,8 +74,8 @@ function tryToAdd(group, module) {
   if (!result) {
     return false;
   }
-  module.dependencies.forEach(depenency => {
-    tryToAdd(group, depenency);
+  module.dependencies.forEach(dependency => {
+    tryToAdd(group, dependency);
   });
   group.merge(nextGroup);
   return true;