Document the .defaults property (#649)

advanced-creation.md

@@ -6,7 +6,8 @@
 
 Example: [gh-got](https://github.com/sindresorhus/gh-got/blob/master/index.js)
 
-Configure a new `got` instance with the provided settings. You can access the settings through `got.defaults`.<br>
+Configure a new `got` instance with the provided settings. You can access the resolved options with the `.defaults` property on the instance.
+
 **Note:** In contrast to `got.extend()`, this method has no defaults.
 
 ##### [options](readme.md#options)

readme.md

@@ -584,7 +584,7 @@ Sets `options.method` to the method name and makes a request.
 
 #### got.extend([options])
 
-Configure a new `got` instance with default `options`. `options` are merged with the parent instance's `defaults.options` using [`got.mergeOptions`](#gotmergeoptionsparentoptions-newoptions).
+Configure a new `got` instance with default `options`. The `options` are merged with the parent instance's `defaults.options` using [`got.mergeOptions`](#gotmergeoptionsparentoptions-newoptions). You can access the resolved options with the `.defaults` property on the instance.
 
 ```js
 const client = got.extend({
@@ -650,6 +650,12 @@ Options are deeply merged to a new object. The value of each key is determined a
 - If the new property is an `Array`, it overwrites the old one with a deep clone of the new property.
 - Otherwise, the new value is assigned to the key.
 
+#### got.defaults
+
+Type: `Object`
+
+The default Got options.
+
 ## Errors
 
 Each error contains (if available) `body`, `statusCode`, `statusMessage`, `host`, `hostname`, `method`, `path`, `protocol` and `url` properties to make debugging easier.