Merge branch 'master' into cn

# Conflicts:
#	content/concepts/configuration.md
#	content/concepts/hot-module-replacement.md
#	content/concepts/modules.md
#	content/concepts/output.md
#	content/concepts/plugins.md
#	content/concepts/targets.md
#	content/configuration/externals.md
#	content/configuration/index.md

Author: dear-lizhihua

.gitignore

@@ -3,4 +3,3 @@ npm-debug.log
 build
 # generated
 .antwar
-

content/concepts/hot-module-replacement.md

@@ -5,6 +5,7 @@ contributors:
 - SpaceK33z
 - sokra
 - GRardB
+- rouzbeh84
 ---
 
 模块热替换功能会在应用程序运行过程中替换、添加或删除[模块](/concepts/modules/)，而无需重新加载页面。这使得你可以在独立模块变更后，无需刷新整个页面，就可以更新这些模块，极大地加速了开发时间。
@@ -35,7 +36,7 @@ manifest 包括新的编译 hash 和所有的待更新 chunk 目录。
 
 ### 站在模块的角度
 
-HMR 是可选功能，只会影响包含 HRM 代码的模块。举个例子，通过 [style-loder](https://github.com/webpack/style-loader) 为 style 样式追加补丁。
+HMR 是可选功能，只会影响包含 HRM 代码的模块。举个例子，通过 [style-loader](https://github.com/webpack/style-loader) 为 style 样式追加补丁。
 为了运行追加补丁，style-loader 实现了 HMR 接口；当它通过 HRM 接收到更新，它会使用新的样式替换旧的样式。
 
 类似的，当在一个模块中实现了 HMR 接口，你可以描述出当模块被更新后发生了什么。然而在多数情况下，不需要强制在每个模块中写入 HMR 代码。如果一个模块没有 HMR 处理函数，更新就会冒泡。这意味着一个简单的处理函数能够对整个模块树(complete module tree)进行处理。如果在这个模块树中，一个单独的模块被更新，那么整个模块树都会被重新加载（只会重新加载，不会迁移）。

content/concepts/modules.md

@@ -4,6 +4,7 @@ sort: 7
 contributors:
   - TheLarkInn
   - simon04
+  - rouzbeh84
 ---
 
 在[模块化编程](https://en.wikipedia.org/wiki/Modular_programming)，开发者将程序分解成称为_模块_的离散功能块。
@@ -40,7 +41,7 @@ webpack 社区已经为以及各种流行语言和语言处理器构建了_加
 * [Less](http://lesscss.org)
 * [Stylus](http://stylus-lang.com)
 
-总的来说，webpack 提供了可定制的、强大和丰富的 API，允许**任何技术栈**使用 webpack，保持了在你的开发、测试和生成流程中**无侵入性**。
+总的来说，webpack 提供了可定制的、强大和丰富的 API，允许**任何技术栈**使用 webpack，保持了在你的开发、测试和生成流程中**无侵入性(non-opinionated)**。
 
 有关完整列表，请参考[**加载器列表**](/loaders) 或 [**自己编写**](/api/loaders)。
 

content/concepts/output.md

@@ -3,6 +3,8 @@ title: 输出(Output)
 sort: 3
 contributors:
   - TheLarkInn
+  - chyipin
+  - rouzbeh84
 ---
 
 选项影响编译输出。`output` 选项控制 webpack 如何向硬盘写入编译文件。注意，即使可以存在多个`入口`起点，但只指定一个`输出`配置。
@@ -11,14 +13,19 @@ contributors:
 
 ## 用法(Usage)
 
-设置 `output` 属性，只需要在你的 webpack 配置简单的设置输出值：
+在 webpack 中配置 `output` 属性的最低要求是，将它的值设置为一个对象，包括以下两点：
+
+编译文件的`文件名(filename)`首选：`// main.js || bundle.js || index.js`
+
+[`output.path`](#output-path) 对应一个**绝对路径**，此路径是你希望一次性打包的目录。
 
 **webpack.config.js**
 
 ```javascript
 const config = {
   output: {
-    filename: 'bundle.js'
+    filename: 'bundle.js',
+    path: '/home/proj/public/assets'
   }
 };
 
@@ -58,6 +65,7 @@ module.exports = config;
 > 默认值：`false`
 
 > 参考[[library and externals]]
+
 > 参考[[Development Tools]]
 
 ### `output.devtoolLineToLine`
@@ -75,7 +83,8 @@ module.exports = config;
 指定硬盘每个输出文件的名称。在这里你**不能**指定绝对路径！`output.path` 选项规定了文件被写入硬盘的位置。`filename` 仅用于命名每个文件。
 
 **单个入口**
-``` javascript
+
+```javascript
 {
   entry: './src/app.js',
   output: {
@@ -192,20 +201,21 @@ output: {
   <link href="/assets/spinner.gif"/>
 </head>
 ```
+
 接下来是一个更复杂的例子，来说明对资源使用 CDN 和 hash。
 
 **config.js**
 
-``` javascript
+```javascript
 output: {
-	path: "/home/proj/cdn/assets/[hash]",
-	publicPath: "http://cdn.example.com/assets/[hash]/"
+    path: "/home/proj/cdn/assets/[hash]",
+    publicPath: "http://cdn.example.com/assets/[hash]/"
 }
 ```
 
 **注意：**在编译时不知道最终输出文件的 `publicPath` 的情况下，`publicPath` 可以留空，并且在入口点文件运行时动态设置。如果你在编译时不知道 `publicPath`，你可以先忽略它，并且在入口点设置 `__webpack_public_path__`。
 
-``` javascript
+```javascript
  __webpack_public_path__ = myRuntimePublicPath
 
 // 其他的应用程序入口

content/concepts/plugins.md

@@ -4,6 +4,7 @@ sort: 5
 contributors:
   - TheLarkInn
   - jhnns
+  - rouzbeh84
 ---
 
 插件是 wepback 的[支柱](https://github.com/webpack/tapable)功能。在你使用 webpack 配置时，webpack 自身也构建于**同样的插件系统**上！
@@ -12,7 +13,7 @@ contributors:
 
 ## 剖析
 
-webpack **插件**是一个具有 `apply` 属性的 JavaScript 对象。 `apply` 属性会被 webpack 解析器(compiler)调用，并且可在整个编译生命周期(compilation lifecycle)访问。
+webpack **插件**是一个具有 [`apply`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/apply) 属性的 JavaScript 对象。 `apply` 属性会被 webpack 解析器(compiler)调用，并且可在整个编译生命周期(compilation lifecycle)访问。
 
 
 **ConsoleLogOnBuildWebpackPlugin.js**

content/concepts/targets.md

@@ -3,6 +3,7 @@ title: 部署目标(Targets)
 sort: 10
 contributors:
   - TheLarkInn
+  - rouzbeh84
 ---
 
 因为服务器和浏览器代码都可以用 JavaScript 编写，所以 webpack 提供了多种部署_目标(target)_，你可以在你的 webpack [配置](/configuration)中设置。
@@ -21,12 +22,13 @@ module.exports = {
 };
 ```
 
-每个_目标_都有各种部署/环境特定的附加项，以支持满足其需求。查看[可用目标](/configuration/target)。
-Each _target_ has a variety of deployment/environment specific additions, support to fit its needs. See what [targets are available](/configuration/target).
+在上面例子中，使用 `node` webpack 会编译为用于「类 Node.js」环境（使用 Node.js 的 `require` ，而不是使用任意内置模块（如 `fs` 或 `path`）来加载 chunk）。
 
-?> We should expand on this further. What specifically is included.
+每个_target_都有各种部署(deployment)/环境(environment)特定的附加项，以支持满足其需求。查看[target 的可用值](/configuration/target)。
 
-## 多个目标
+?>Further expansion for other popular target values
+
+## 多个 Target
 
 尽管 webpack 不支持向 `target` 传入多个字符串，你可以通过打包两份分离的配置来创建同构的库：
 
@@ -62,7 +64,7 @@ module.exports = [ serverConfig, clientConfig ];
 
 ### 打包输出比较
 
-  **[compare-webpack-target-bundles](https://github.com/TheLarkInn/compare-webpack-target-bundles)**：大量有关「测试和查看不同的 webpack _目标_」的资源。也有大量 bug 报告。
+  **[compare-webpack-target-bundles](https://github.com/TheLarkInn/compare-webpack-target-bundles)**：大量有关「测试和查看不同的 webpack _target_」的资源。也有大量 bug 报告。
 
 ?> Need to find up to date examples of these webpack targets being used in live code or boilerplates.
 

content/configuration/entry-context.md

@@ -4,9 +4,10 @@ sort: 4
 contributors:
   - sokra
   - skipjack
+  - tarang9211
 ---
 
-?> TODO: Short description
+The entry object is where Webpack looks to start building the bundle. The context is an absolute string to the directory that contains the entry files.
 
 ## `context`
 

content/configuration/externals.md

@@ -52,6 +52,7 @@ Your bundle which has external dependencies can be used in various module contex
 
   * __global__ - An external library can be available as a global variable. The consumer can achieve this by including the external library in a script tag. This is the default setting for externals.
   * __commonjs__ -  The consumer application may be using a CommonJS module system and hence the external library should be available as a CommonJS module.
+  * __commonjs2__ -  Similar to the above line but where the export is `module.exports.default`.
   * __amd__ - Similar to the above line but using AMD module system.
 
 `externals` accepts various syntax and interprets them in different manners.

content/configuration/index.md

@@ -130,8 +130,8 @@ var path = require('path');
         [exclude](/configuration/module#rule-exclude): [
           path.resolve(__dirname, "app/demo-files")
         ]
-        // 匹配条件，每个选项都接收正则表达式或字符串
-        // test 和 include 行为等同，都是必须匹配选项
+        // 这里是匹配条件，每个选项都接收一个正则表达式或字符串
+        // test 和 include 具有相同的作用，都是必须匹配选项
         // exclude 是必不匹配选项（优先于 test 和 include）
         // 最佳实践：
         // - 只在 test 和 文件名匹配 中使用正则表达式
@@ -143,7 +143,7 @@ var path = require('path');
 
         [enforce](/configuration/module#rule-enforce): "pre",
         [enforce](/configuration/module#rule-enforce): "post",
-        // 即使规则被覆盖也要应用这些规则（高级选项）
+        // 标识应用这些规则，即使规则覆盖（高级选项）
 
         [loader](/configuration/module#rule-loader): "babel-loader",
         // 应该应用的 loader，它相对上下文解析

content/configuration/resolve.md

@@ -238,11 +238,11 @@ W> Changes to cached paths may cause failure in rare cases.
 
 `object`
 
-This set of options is identical to the `resolve` set above, but is used only to resolve webpack's [loader](/concepts/loaders) packages. Default:
+This set of options is identical to the `resolve` property set above, but is used only to resolve webpack's [loader](/concepts/loaders) packages. Default:
 
 ```js
 {
-    modulesDirectories: ["web_loaders", "web_modules", "node_loaders", "node_modules"],
+    modules: ["web_loaders", "web_modules", "node_loaders", "node_modules"],
     extensions: ["", ".webpack-loader.js", ".web-loader.js", ".loader.js", ".js"],
     packageMains: ["webpackLoader", "webLoader", "loader", "main"]
 }

content/guides/code-splitting-require.md

@@ -3,6 +3,7 @@ title: 代码拆分 - 使用 require.ensure
 sort: 5
 contributors:
   - pksjce
+  - rahulcs
 ---
 
 In this section, we will discuss how webpack splits code using `require.ensure()`.
@@ -74,6 +75,8 @@ On running webpack on this project, we find that webpack has created two new bun
 
 `b.js` is bundled in `0.bundle.js`.
 
+?> `require.ensure` relies on `Promises` internally. If you use `require.ensure` with older browsers, remember to shim `Promise.` [es6-promise polyfill](https://github.com/stefanpenner/es6-promise).
+
 ## Gotchas for `require.ensure()`
 
 ### Empty Array as Parameter

content/guides/development.md

@@ -18,6 +18,7 @@ Each editor has a different way of disabling this. For the most common ones:
 * **Sublime Text 3** - Add `"atomic_save": false` to your user preferences.
 * **IntelliJ** - use search in the preferences to find "safe write" and disable it.
 * **Vim** - add `:set backupcopy=yes` in your settings.
+* **WebStorm** - uncheck `Use "safe write"` in Preferences > Appearance & Behavior > System Settings
 
 ## Source Maps
 

content/guides/webpack-and-typescript.md

@@ -116,7 +116,7 @@ module.exports = {
      },
      {
        enforce: 'pre',
-       test: /\.js$/,
+       test: /\.tsx?$/,
        use: "source-map-loader"
      }
    ]