Merge branch 'master' into issues/3116

Author: EugeneHlushko

src/content/contribute/index.md

@@ -7,6 +7,7 @@ contributors:
   - harrynewsome
   - dhedgecock
   - tbroadley
+  - EugeneHlushko
 ---
 
 The people who contribute to webpack do so for the love of open source, our users and ecosystem, and most importantly, pushing the web forward together. Because of our [Open Collective](https://opencollective.com/webpack) model for funding and transparency, we are able to funnel support and funds through contributors, dependent projects, and the contributor and core teams. To make a donation, simply click the button below...
@@ -29,7 +30,7 @@ The biggest core feature we'd like to provide is an enjoyable development experi
 Anybody can help by doing any of the following:
 
 - Ask your employer to use webpack in projects.
-- Help us write and maintain the content on this site (see the [writer's guide](/writers-guide)).
+- Help us write and maintain the content on this site (see the [writer's guide](/contribute/writers-guide/)).
 - Contribute to the [core repository](https://github.com/webpack/webpack).
 - Become a backer or sponsor on [open collective](https://opencollective.com/webpack#support).
 

src/content/plugins/progress-plugin.md

@@ -6,11 +6,22 @@ contributors:
   - byzyk
 ---
 
+`object` `function (percentage: number, message: string, ...args: string[])`
+
 The `ProgressPlugin` provides a way to customize how progress is reported during a compilation.
 
 ## Usage
 
-Create an instance of `ProgressPlugin` with a handler function which will be called when hooks report progress:
+Create an instance of `ProgressPlugin` and provide one of the allowed params.
+
+### Providing `function`
+ 
+Provide a handler function which will be called when hooks report progress. `handler` function arguments:
+
+- `percentage`: a number between 0 and 1 indicating the completion percentage of the compilation
+- `message`: a short description of the currently-executing hook
+- `...args`: zero or more additional strings describing the current progress
+
 
 ```js
 const handler = (percentage, message, ...args) => {
@@ -21,10 +32,30 @@ const handler = (percentage, message, ...args) => {
 new webpack.ProgressPlugin(handler);
 ```
 
-- `handler` is a function which takes these arguments:
-- `percentage`: a number between 0 and 1 indicating the completion percentage of the compilation.
-- `message`: a short description of the currently-executing hook.
-- `...args`: zero or more additional strings describing the current progress.
+### Providing `object`
+
+When providing an `object` to the `ProgressPlugin`, following properties are supported:
+
+- `activeModules: boolean = true` show's active modules count and one active module in progress message
+- `entries: boolean = false` show's entries count in progress message
+- [`handler: function(percentage, message, ...args)`](#providing-function)
+- `modules: boolean = true` show's modules count in progress message
+- `modulesCount: number = 500` a minimum modules count to start with. Takes effect when `modules` property is enabled.
+- `profile: true | false | null = false` tells `ProgressPlugin` to collect profile data for progress steps.
+
+
+```js
+new webpack.ProgressPlugin({
+  entries: true,
+  modules: true,
+  modulesCount: 100,
+  profile: true,
+  handler: (percentage, message, ...args) => {
+    // custom logic
+  }
+});
+```
+
 
 ## Supported Hooks
 

src/content/plugins/split-chunks-plugin.md

@@ -11,6 +11,7 @@ contributors:
   - madhavarshney
   - sakhisheikh
   - superburrito
+  - ryandrew14
 related:
   - title: webpack's automatic deduplication algorithm example
     url: https://github.com/webpack/webpack/blob/master/examples/many-pages/README.md
@@ -171,6 +172,8 @@ The name of the split chunk. Providing `true` will automatically generate a name
 
 Providing a string or a function allows you to use a custom name. Specifying either a string or a function that always returns the same string will merge all common modules and vendors into a single chunk. This might lead to bigger initial downloads and slow down page loads.
 
+If you choose to specify a function, you may find the `chunk.name` and `chunk.hash` properties (where `chunk` is an element of the `chunks` array) particularly useful in choosing a name for your chunk.
+
 If the `splitChunks.name` matches an [entry point](/configuration/entry-context/#entry) name, the entry point will be removed.
 
 T> It is recommended to set `splitChunks.name` to `false` for production builds so that it doesn't change names unnecessarily.