diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index 211b23a5eb9..422b3cfddeb 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -47,7 +47,8 @@ It creates a new `BrowserWindow` with native properties as set by the `options`.
   * `maxWidth` Integer - Window's maximum width. Default is no limit.
   * `maxHeight` Integer - Window's maximum height. Default is no limit.
   * `resizable` Boolean - Whether window is resizable. Default is `true`.
-  * `movable` Boolean - Whether window is movable. Default is `true`.
+  * `movable` Boolean - Whether window is movable. This is only implemented
+    on OS X. Default is `true`.
   * `alwaysOnTop` Boolean - Whether the window should always stay on top of
     other windows. Default is `false`.
   * `fullscreen` Boolean - Whether the window should show in fullscreen. When