diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index 86330bf0f934..5f96beca830c 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -179,10 +179,14 @@ Emitted when window is getting resized.
 
 Emitted when the window is getting moved to a new position.
 
+__Note__: On OS X this event is just an alias of `moved`.
+
 ### Event: 'moved'
 
 Emitted once when the window is moved to a new position.
 
+__Note__: This event is available only on OS X.
+
 ### Event: 'enter-full-screen'
 
 Emitted when window enters full screen state.