From e8f0331aeb81b0f42bfd8af111d3c3d0b6381c1a Mon Sep 17 00:00:00 2001
From: Vadim Macagon <vadim.macagon@gmail.com>
Date: Fri, 10 Feb 2017 10:33:33 +0700
Subject: [PATCH] Improve docs for `will-attach-webview` event

---
 docs/api/web-contents.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index d30a34f8ec..781436509f 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -516,6 +516,10 @@ Returns:
 Emitted when a `<webview>`'s web contents is being attached to this web
 contents. Calling `event.preventDefault()` will destroy the guest page.
 
+This event can be used to configure `webPreferences` for the `webContents`
+of a `<webview>` before it's loaded, and provides the ability to set settings
+that can't be set via `<webview>` attributes.
+
 ### Instance Methods
 
 #### `contents.loadURL(url[, options])`