diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index a01d1037ee74..f03c0cc91e42 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -1346,8 +1346,9 @@ Changes window icon.
 
 * `visible` Boolean
 
-Sets whether the window traffic light buttons should be visible. This has no
-effect when `titleBarStyle` is set to `customButtonsOnHover`.
+Sets whether the window traffic light buttons should be visible.
+
+This cannot be called when `titleBarStyle` is set to `customButtonsOnHover`.
 
 #### `win.setAutoHideMenuBar(hide)`