more updates to api summaries based on feedback

docs/api/auto-updater.md

@@ -1,8 +1,8 @@
 # autoUpdater
 
-> Enable apps to update themselves automatically.
+> Enable apps to automatically update themselves.
 
-The `autoUpdater` module provides and interface for the [Squirrel](https://github.com/Squirrel) framework.
+The `autoUpdater` module provides an interface for the [Squirrel](https://github.com/Squirrel) framework.
 
 You can quickly launch a multi-platform release server for distributing your
 application by using one of these projects:

docs/api/chrome-command-line-switches.md

@@ -3,8 +3,8 @@
 > Command line switches supported by Electron.
 
 You can use [app.commandLine.appendSwitch][append-switch] to append them in
-your app's main script before the [ready][ready] event of [app][app] module is
-emitted:
+your app's main script before the [ready][ready] event of the [app][app] module
+is emitted:
 
 ```javascript
 const app = require('electron').app;

docs/api/content-tracing.md

@@ -3,9 +3,9 @@
 > Collect tracing data from Chromium's content module for finding performance
 bottlenecks and slow operations.
 
-This module does not include a web interface
-so you need to open `chrome://tracing/` in a Chrome browser and load the
-generated file to view the result.
+This module does not include a web interface so you need to open
+`chrome://tracing/` in a Chrome browser and load the generated file to view the
+result.
 
 ```javascript
 const contentTracing = require('electron').contentTracing;

docs/api/menu-item.md

@@ -1,6 +1,6 @@
 # MenuItem
 
-> Add items to application and context menus.
+> Add items to native application menus and context menus.
 
 See [`menu`](menu.md) for examples.
 

docs/api/protocol.md

@@ -1,6 +1,6 @@
 # protocol
 
-> Register a custom protocol and intercept existing protocols.
+> Register a custom protocol and intercept existing protocol requests.
 
 An example of implementing a protocol that has the same effect as the
 `file://` protocol:

docs/api/window-open.md

@@ -1,6 +1,6 @@
 # The `window.open` function
 
-> Create a new window in a web page.
+> Open a new window and load a URL.
 
 When `window.open` is called to create a new window in a web page, a new instance
 of `BrowserWindow` will be created for the `url` and a proxy will be returned