docs(config): add explanations for gatherers property

GoogleChrome · Jul 17, 2017 · 1f6cd1e · 1f6cd1e
1 parent 5d61056
commit 1f6cd1e
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 1 deletion.
diff --git a/docs/configuration.md b/docs/configuration.md
@@ -121,7 +121,7 @@ Each `passes` entry defines basic settings such as how long to wait for the page
 | networkQuietThresholdMs | `number` | The number of milliseconds since the last network request to wait before the page should be considered to have reached 'network quiet'. Used to ensure the page has had time for the full waterfall of network requests to complete before ending a trace. (Default: 5000) |
 | pauseAfterNetworkQuietMs | `number` | The number of milliseconds to wait after 'network quiet' before the pass can continue. Used to ensure the page has had time for post-network-quiet JavaScript to execute before ending a trace. (Default: 0) |
 | blockedUrlPatterns | `string[]` | URLs of requests to block while loading the page. Basic wildcard support using `*`.  |
-| gatherers | `string[]` | The list of gatherers to run on this pass. |
+| gatherers | `string[]` | The list of gatherers to run on this pass. This property is required and on extension will be concatenated with the existing set of gatherers. |
 
 ### `audits: string[]`
 

diff --git a/lighthouse-core/config/fast-config.js b/lighthouse-core/config/fast-config.js
@@ -26,10 +26,12 @@ module.exports = {
   passes: [
     {
       passName: 'defaultPass',
+      // overwrite the throttling and load wait parameters
       useThrottling: false,
       pauseAfterLoadMs: 0,
       networkQuietThresholdMs: 500,
       cpuQuietThresholdMs: 500,
+      // no need to add any gatherers yet, but this property is required
       gatherers: [],
     },
   ],