diff --git a/docs/api/window-open.md b/docs/api/window-open.md
index fd57790042cf..4757f1ffe02b 100644
--- a/docs/api/window-open.md
+++ b/docs/api/window-open.md
@@ -10,8 +10,8 @@ The proxy has limited standard functionality implemented to be
 compatible with traditional web pages. For full control of the new window
 you should create a `BrowserWindow` directly.
 
-The newly created `BrowserWindow` will inherit parent window's options by
-default, to override inherited options you can set them in the `features`
+The newly created `BrowserWindow` will inherit the parent window's options by
+default. To override inherited options you can set them in the `features`
 string.
 
 ### `window.open(url[, frameName][, features])`
@@ -45,33 +45,33 @@ limited functionality with the child window.
 
 The `BrowserWindowProxy` object has the following instance methods:
 
-#### `BrowserWindowProxy.blur()`
+#### `win.blur()`
 
 Removes focus from the child window.
 
-#### `BrowserWindowProxy.close()`
+#### `win.close()`
 
 Forcefully closes the child window without calling its unload event.
 
-#### `BrowserWindowProxy.closed`
+#### `win.closed`
 
 Set to true after the child window gets closed.
 
-#### `BrowserWindowProxy.eval(code)`
+#### `win.eval(code)`
 
 * `code` String
 
 Evaluates the code in the child window.
 
-#### `BrowserWindowProxy.focus()`
+#### `win.focus()`
 
 Focuses the child window (brings the window to front).
 
-#### `BrowserWindowProxy.print()`
+#### `win.print()`
 
 Invokes the print dialog on the child window.
 
-#### `BrowserWindowProxy.postMessage(message, targetOrigin)`
+#### `win.postMessage(message, targetOrigin)`
 
 * `message` String
 * `targetOrigin` String