diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index ea8822059835..895547c46e85 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -96,6 +96,11 @@ It creates a new `BrowserWindow` with native properties as set by the `options`.
   * `webPreferences` Object - Settings of web page's features. See more about
     this below.
 
+When setting minimum or maximum window size with `minWidth`/`maxWidth`/
+`minHeight`/`maxHeight`, it only constrains the users, it won't prevent you from
+passing a size that does not follow size constraints to `setBounds`/`setSize` or
+to the constructor of `BrowserWindow`.
+
 The possible values and behaviors of `type` option are platform dependent,
 supported values are: