From aaeef721b3d17804e5d796bac7f49449857ea955 Mon Sep 17 00:00:00 2001
From: Alex Middeleer <almiddeleer@gmail.com>
Date: Wed, 8 Jul 2020 14:03:38 +0200
Subject: [PATCH] docs: add suggestion to deprecated attachToDocument

---
 docs/api/options.md | 43 ++++++++++++++++++++++++++++---------------
 1 file changed, 28 insertions(+), 15 deletions(-)

diff --git a/docs/api/options.md b/docs/api/options.md
index 70a54db82..dddf6366e 100644
--- a/docs/api/options.md
+++ b/docs/api/options.md
@@ -9,20 +9,22 @@ These options will be merged with the component's existing options when mounted
 [See other options for examples](#other-options)
 :::
 
-- [`context`](#context)
-- [`data`](#data)
-- [`slots`](#slots)
-- [`scopedSlots`](#scopedslots)
-- [`stubs`](#stubs)
-- [`mocks`](#mocks)
-- [`localVue`](#localvue)
-- [`attachTo`](#attachto)
-- [`attachToDocument`](#attachtodocument)
-- [`propsData`](#propsdata)
-- [`attrs`](#attrs)
-- [`listeners`](#listeners)
-- [`parentComponent`](#parentcomponent)
-- [`provide`](#provide)
+- [Mounting Options](#mounting-options)
+  - [context](#context)
+  - [data](#data)
+  - [slots](#slots)
+  - [scopedSlots](#scopedslots)
+  - [stubs](#stubs)
+  - [mocks](#mocks)
+  - [localVue](#localvue)
+  - [attachTo](#attachto)
+  - [attachToDocument](#attachtodocument)
+  - [attrs](#attrs)
+  - [propsData](#propsdata)
+  - [listeners](#listeners)
+  - [parentComponent](#parentcomponent)
+  - [provide](#provide)
+  - [Other options](#other-options)
 
 ## context
 
@@ -327,7 +329,18 @@ wrapper.destroy()
 - default: `false`
 
 ::: warning Deprecation warning
-`attachToDocument` is deprecated and will be removed in future releases. Use [`attachTo`](#attachto) instead.
+`attachToDocument` is deprecated and will be removed in future releases. Use [`attachTo`](#attachto) instead. For example, if you need to attach the component to the document.body:
+
+```js
+const elem = document.createElement('div')
+if (document.body) {
+  document.body.appendChild(elem)
+}
+wrapper = mount(Component, {
+  attachTo: elem
+})
+```
+
 :::
 
 Like [`attachTo`](#attachto), but automatically creates a new `div` element for you and inserts it into the body.