diff --git a/docs/configuration.md b/docs/configuration.md index ccee8c643375..5ad909268beb 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -46,9 +46,11 @@ lighthouse('https://example.com/', {port: 9222}, config); | categories | Object|undefined | | groups | Object|undefined | -### `extends: string|boolean|undefined` +### `extends: "lighthouse:default"|boolean|undefined` -The extends property controls if your configuration should inherit from the default Lighthouse configuration. [Learn more.](#config-extension) +The `extends` property controls if your configuration should inherit from the default Lighthouse configuration. [Learn more.](#config-extension) + +Both the values `"lighthouse:default"` and `true` will enable inheritance, while `false` and `undefined` will not. #### Example ```js @@ -197,7 +199,7 @@ The groups property controls how to visually group audits within a category. For The stock Lighthouse configurations can be extended if you only need to make small tweaks, such as adding an audit or skipping an audit, but wish to still run most of what Lighthouse offers. When adding the `extends: 'lighthouse:default'` property to your config, the default passes, audits, groups, and categories will be automatically included, allowing you modify settings or add additional audits to a pass. -Please note that you can only extend from `lighthouse:default` using the `extends` property. Other internal configs found in the [lighthouse-core/config](https://github.com/GoogleChrome/lighthouse/tree/master/lighthouse-core/config) directory can be used by importing the config object from file reference, or by using the [`--preset`](https://github.com/GoogleChrome/lighthouse#cli-options) CLI flag. +Please note that the `extends` property only supports extension of `lighthouse:default`. Other internal configs found in the [lighthouse-core/config](https://github.com/GoogleChrome/lighthouse/tree/master/lighthouse-core/config) directory can be used by importing the config object from file reference, or by using the [`--preset`](https://github.com/GoogleChrome/lighthouse#cli-options) CLI flag. See [more examples below](#more-examples) to view different types of extensions in action.