diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index 66218ecb3b73..dada6083ea61 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -117,6 +117,8 @@ Properties `width` and `height` are required.
 
 The `BrowserWindow` object emits the following events:
 
++**Note** Some events are only available on specific operating systems and are labeled as such.
+
 ### Event: 'page-title-updated'
 
 Returns:
@@ -290,6 +292,8 @@ Remove the devtools extension whose name is `name`.
 
 Objects created with `new BrowserWindow` have the following instance methods:
 
++**Note** Some methods are only available on specific operating systems and are labeled as such.
+
 ```javascript
 var BrowserWindow = require('browser-window');