diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index ae0c8fe7e36..8624bc360aa 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -366,14 +366,14 @@ Returns whether the window is in kiosk mode.
 
 * `filename` String
 
-__OS X Only__ Sets the pathname of the file the window represents, and the icon
+__OS X Only:__ Sets the pathname of the file the window represents, and the icon
 of the file will show in window's title bar.
 
 ### BrowserWindow.setDocumentEdited(edited)
 
 * `edited` Boolean
 
-__OS X Only__ Specifies whether the window’s document has been edited, and the
+__OS X Only:__ Specifies whether the window’s document has been edited, and the
 icon in titlebar will become grey when set to `true`.
 
 ### BrowserWindow.openDevTools()
@@ -422,12 +422,16 @@ Same with `webContents.loadUrl(url)`.
 
 ### BrowserWindow.reload()
 
-Reloads the current url.
+Same with `webContents.reload`.
 
 ### BrowserWindow.setMenu(menu)
 
+* `menu` Menu
+
 Sets the `menu` as the window top menu.
 
+__Note:__ This API is not available on OS X.
+
 ## Class: WebContents
 
 A `WebContents` is responsible for rendering and controlling a web page.