This includes small updates to the inspectedWindow.html documentation.

chrome/common/extensions/docs/static/experimental.devtools.inspectedWindow.html

Index: chrome/common/extensions/docs/static/experimental.devtools.inspectedWindow.html
===================================================================
--- chrome/common/extensions/docs/static/experimental.devtools.inspectedWindow.html	(revision 109075)
+++ chrome/common/extensions/docs/static/experimental.devtools.inspectedWindow.html	(working copy)
@@ -4,31 +4,44 @@
 <p>
 Use <code>chrome.experimental.devtools.inspectedWindow</code> to interact with
 the inspected window: obtain tab ID for the inspected page, evaluate the code
-in the context of inspected window, reload the page.
+in the context of inspected window, reload the page,
+obtain the list of resources within the page.
 </p><p>
 See <a href="experimental.devtools.html">DevTools APIs summary</a> for
 general introduction to using Developer Tools APIs.
 </p>
 
-<h2>Notes</h2>
+<h2>Overview</h2>
 <p>
 The <a href="#property-tabId"><code>tabId</code></a> property 
-provides tab identifier that may be used with the <a href="tabs.html">
+provides the tab identifier that may be used with the <a href="tabs.html">
 <code>chrome.tabs.*</code></a> API calls.
 However, please note that <code>chrome.tabs.*</code> API is not
 exposed to the Developer Tools extension pages due to security considerations
 &mdash; you will need to pass the tab ID to the background page and invoke
 the <code>chrome.tabs.*</code> API functions from there.
-</p></p>
+</p>
+<p>
 The <code>eval()</code> method provides the ability for extensions to execute
 JavaScript code in the context of the main frame of the inspected page.
-This method is different from 
-<code>chrome.tabs.executeScript()</code> in the following aspects:
+This method if powerful when used in the right context,
+and dangerous when used inappropriately.
+In key instances, 
+the <code>chrome.tabs.executeScript()</code> should be used instead.
+</p>
+<p>Here are the main differences between the
+<code>eval()</code> and <code>chrome.tabs.executeScript()</code> methods:
 </p><ul>
 <li>The <code>eval()</code> method does not
 use an isolated world for the code being evaluated, so the JavaScript state
 of the inspected window is accessible to the code.
+Use this method when access to the JavaScript state of the inspected page 
+is required.
 </li><li>
+The execution context of the code being evaluated includes the 
+<a href="http://code.google.com/chrome/devtools/docs/console.html">Developer
+Tools console API</a> (e.g. <code>inspect()</code>, <code>$0</code> etc).
+</li><li>
 The evaluated code may return a value that is passed to the extension callback.
 The returned value has to be a valid JSON object (i.e. may contain only
 primitive JavaScript types and acyclic references to other JSON
@@ -38,12 +51,7 @@
 inspected page &mdash; the execution context is essentially controlled by the
 inspected page; a malicious page may affect the data being returned to the
 extension.</em>
-</li><li>
-The execution context of the code being evaluated includes the 
-<a href="http://code.google.com/chrome/devtools/docs/console.html">Developer
-Tools console API</a> (e.g. <code>inspect()</code>, <code>$0</code> etc).
-</li>
-</ul>
+</li></ul>
 <p class="caution">
 <strong>Important:</strong> 
 Due to the security considerations explained above, the