[docs] clarify the inner vs outter dimension in various places

rogerwang · rogerwang · commit 9ea89729a3fa · 2019-11-18T19:58:55.000-07:00
diff --git a/docs/References/Manifest Format.md b/docs/References/Manifest Format.md
@@ -198,7 +198,7 @@ All of the window subfields can be overwritten by using [`new-win-policy` event]
 ### width
 ### height
 
-* `{Integer}` the initial width/height of the main window.
+* `{Integer}` the initial inner width/height of the main window.
 
 ### toolbar
 
@@ -218,12 +218,12 @@ All of the window subfields can be overwritten by using [`new-win-policy` event]
 ### min_width
 ### min_height
 
-* `{Integer}` minimum width/height of window
+* `{Integer}` minimum inner width/height of window
 
 ### max_width
 ### max_height
 
-* `{Integer}` maximum width/height of window
+* `{Integer}` maximum inner width/height of window
 
 ### as_desktop (Linux)
 
diff --git a/docs/References/Window.md b/docs/References/Window.md
@@ -91,12 +91,12 @@ Get the corresponding DOM window object of the native window.
 ## win.x
 ## win.y
 
-Get or set left/top offset from window to screen.
+Get or set left/top offset from window frame to screen.
 
 ## win.width
 ## win.height
 
-Get or set window's size.
+Get or set window's size, including the window's frame.
 
 ## win.title
 
@@ -150,8 +150,8 @@ Moves a window a specified number of pixels relative to its current coordinates.
 
 ## win.resizeTo(width, height)
 
-* `width` `{Integer}` the width of the window
-* `height` `{Integer}` the height of the window
+* `width` `{Integer}` the inner width of the window
+* `height` `{Integer}` the inner height of the window
 
 Resizes a window to the specified `width` and `height`.
 
