Updated some more documentation to be more clear.

tools/dom/docs/docs.json

Index: tools/dom/docs/docs.json
diff --git a/tools/dom/docs/docs.json b/tools/dom/docs/docs.json
index 43706bc4cb088d7bacd04fd9f684bf41b4639a9a..c587efd850cc8ff8f13c16301b142d520092826f 100644
--- a/tools/dom/docs/docs.json
+++ b/tools/dom/docs/docs.json
@@ -2908,12 +2908,14 @@
         " * Top-level container for the current browser tab or window.",
         " *",
         " * In a web browser, each window has a [Window] object, but within the context",
-        " * of a script, a [Window] object represents only the current window. In",
-        " * addition to the open window, each window, tab, and iframe has its own",
-        " * [Window] object. A [Window] contains a [Document] object, which contains this",
-        " * web page's content.",
+        " * of a script, this object represents only the current window.",
+        " * Each other window, tab, and iframe has its own [Window] object.",
         " *",
-        " * Use `window` to access properties of the current window. For example:",
+        " * Each window contains a [Document] object, which contains all of the window's",
+        " * content.",
+        " *",
+        " * Use the top-level `window` object to access the current window.",
+        " * For example:",
         " *",
         " *     // Draw a scene when the window repaints.",
         " *     drawScene(num delta) {...}",
@@ -2923,8 +2925,12 @@
         " *     window.console.log('Jinkies!');",
         " *     window.console.error('Jeepers!');",
         " *",
-        " * **Note:** This class represents the current window, whereas [WindowBase] is",
-        " * a representation of any window, including other tabs, windows, and frames.",
+        " * **Note:** This class represents only the current window, while [WindowBase]",
+        " * is a representation of any window, including other tabs, windows, and frames.",
+        " *",
+        " * ## See also",
+        " *",
+        " * [WindowBase]",
         " *",
         " * ## Other resources",
         " *",