Updated some more documentation to be more clear.

tools/dom/docs/docs.json

 {
   "dart.dom.html": {
     "AbstractWorker": {
       "members": {
         "errorEvent": [
           "/**",
           "   * Static factory designed to expose `error` events to event",
           "   * handlers that are not necessarily instances of [AbstractWorker].",
           "   *",
           "   * See [EventStreamProvider] for usage information.",
@@ skipping 2890 matching lines @@
           "   */"
         ]
       }
     },
     "Window": {
       "comment": [
         "/**",
         " * 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) {...}",
         " *     window.animationFrame.then(drawScene);.",
         " *",
         " *     // Write to the console.",
         " *     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",
         " *",
         " * * [DOM Window](https://developer.mozilla.org/en-US/docs/DOM/window) from MDN.",
         " * * [Window](http://www.w3.org/TR/Window/) from the W3C.",
         " */"
       ],
       "members": {
         "devicemotionEvent": [
           "/**",
@@ skipping 1381 matching lines @@
           "   *",
           "   * [oldVersion] should match the database's current [version] exactly.",
           "   *",
           "   * * [Database.changeVersion](http://www.w3.org/TR/webdatabase/#dom-database-changeversion) from W3C.",
           "   */"
         ]
       }
     }
   }
 }