diff --git a/docs/api/accelerator.md b/docs/api/accelerator.md
index 83d8d3a7c2de..cf28e01037a2 100644
--- a/docs/api/accelerator.md
+++ b/docs/api/accelerator.md
@@ -1,7 +1,9 @@
 # Accelerator
 
-An accelerator is a string that represents a keyboard shortcut. It can contain
-multiple modifiers and key codes, combined by the `+` character.
+> Define keyboard shortcuts.
+
+Accelerators can contain multiple modifiers and key codes, combined by
+the `+` character.
 
 Examples:
 
diff --git a/docs/api/app.md b/docs/api/app.md
index 54e40263eab9..8a2cdcfd9224 100644
--- a/docs/api/app.md
+++ b/docs/api/app.md
@@ -1,6 +1,6 @@
 # app
 
-The `app` module is responsible for controlling the application's lifecycle.
+> Control your application's event lifecycle.
 
 The following example shows how to quit the application when the last window is
 closed:
diff --git a/docs/api/auto-updater.md b/docs/api/auto-updater.md
index dccae1212aa0..211d0c69a5f3 100644
--- a/docs/api/auto-updater.md
+++ b/docs/api/auto-updater.md
@@ -1,6 +1,8 @@
 # autoUpdater
 
-This module provides an interface for the `Squirrel` auto-updater framework.
+> Enable apps to automatically update themselves.
+
+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:
diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index c24972815266..7289057b40eb 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -1,7 +1,6 @@
 # BrowserWindow
 
-The `BrowserWindow` class gives you the ability to create a browser window. For
-example:
+> Create and control browser windows.
 
 ```javascript
 // In the main process.
diff --git a/docs/api/chrome-command-line-switches.md b/docs/api/chrome-command-line-switches.md
index 8e8aa38e62dc..17059435eaa7 100644
--- a/docs/api/chrome-command-line-switches.md
+++ b/docs/api/chrome-command-line-switches.md
@@ -1,9 +1,10 @@
 # Supported Chrome command line switches
 
-This page lists the command line switches used by the Chrome browser that are
-also 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:
+> 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 the [app][app] module
+is emitted:
 
 ```javascript
 const app = require('electron').app;
diff --git a/docs/api/clipboard.md b/docs/api/clipboard.md
index 7f95a1af26d2..58e5a1c1b096 100644
--- a/docs/api/clipboard.md
+++ b/docs/api/clipboard.md
@@ -1,6 +1,7 @@
 # clipboard
 
-The `clipboard` module provides methods to perform copy and paste operations.
+> Perform copy and paste operations on the system clipboard.
+
 The following example shows how to write a string to the clipboard:
 
 ```javascript
diff --git a/docs/api/content-tracing.md b/docs/api/content-tracing.md
index 0b83c2759c67..a9414d348764 100644
--- a/docs/api/content-tracing.md
+++ b/docs/api/content-tracing.md
@@ -1,9 +1,11 @@
 # contentTracing
 
-The `content-tracing` module is used to collect tracing data generated by the
-underlying Chromium content module. 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.
+> 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.
 
 ```javascript
 const contentTracing = require('electron').contentTracing;
diff --git a/docs/api/crash-reporter.md b/docs/api/crash-reporter.md
index 9b7141e364e9..1f8229eaa792 100644
--- a/docs/api/crash-reporter.md
+++ b/docs/api/crash-reporter.md
@@ -1,6 +1,6 @@
 # crashReporter
 
-The `crash-reporter` module enables sending your app's crash reports.
+> Submit crash reports to a remote server.
 
 The following is an example of automatically submitting a crash report to a
 remote server:
diff --git a/docs/api/desktop-capturer.md b/docs/api/desktop-capturer.md
index b39a09e5aa8b..dc523c3a42f9 100644
--- a/docs/api/desktop-capturer.md
+++ b/docs/api/desktop-capturer.md
@@ -1,7 +1,7 @@
 # desktopCapturer
 
-The `desktopCapturer` module can be used to get available sources that can be
-used to be captured with `getUserMedia`.
+> List `getUserMedia` sources for capturing audio, video, and images from a
+microphone, camera, or screen.
 
 ```javascript
 // In the renderer process.
diff --git a/docs/api/dialog.md b/docs/api/dialog.md
index 3eb0292a4937..a5f61a53e3f8 100644
--- a/docs/api/dialog.md
+++ b/docs/api/dialog.md
@@ -1,8 +1,6 @@
 # dialog
 
-The `dialog` module provides APIs to show native system dialogs, such as opening
-files or alerting, so web applications can deliver the same user experience as
-native applications.
+> Display native system dialogs for opening and saving files, alerting, etc.
 
 An example of showing a dialog to select multiple files and directories:
 
diff --git a/docs/api/download-item.md b/docs/api/download-item.md
index f117ffc57a78..4418f61c19fb 100644
--- a/docs/api/download-item.md
+++ b/docs/api/download-item.md
@@ -1,7 +1,9 @@
 # DownloadItem
 
-`DownloadItem` is an EventEmitter represents a download item in Electron. It
-is used in `will-download` event of `Session` module, and allows users to
+> Control file downloads from remote sources.
+
+`DownloadItem` is an EventEmitter that represents a download item in Electron.
+It is used in `will-download` event of `Session` module, and allows users to
 control the download item.
 
 ```javascript
diff --git a/docs/api/environment-variables.md b/docs/api/environment-variables.md
index 3483c19d6431..7339661b09fe 100644
--- a/docs/api/environment-variables.md
+++ b/docs/api/environment-variables.md
@@ -1,5 +1,7 @@
 # Environment variables
 
+> Control application configuration and behavior without changing code.
+
 Some behaviors of Electron are controlled by environment variables, because they
 are initialized earlier than command line and the app's code.
 
diff --git a/docs/api/file-object.md b/docs/api/file-object.md
index 01d49c39155f..31c6feddb50b 100644
--- a/docs/api/file-object.md
+++ b/docs/api/file-object.md
@@ -1,5 +1,7 @@
 # `File` object
 
+> Use the HTML5 `File` API to work natively with files on the filesystem.
+
 The DOM's File interface provides abstraction around native files in order to
 let users work on native files directly with the HTML5 file API. Electron has
 added a `path` attribute to the `File` interface which exposes the file's real
diff --git a/docs/api/frameless-window.md b/docs/api/frameless-window.md
index 8e1dd46ec56e..12497db4dae9 100644
--- a/docs/api/frameless-window.md
+++ b/docs/api/frameless-window.md
@@ -1,5 +1,7 @@
 # Frameless Window
 
+> Open a window without toolbars, borders, or other graphical "chrome".
+
 A frameless window is a window that has no
 [chrome](https://developer.mozilla.org/en-US/docs/Glossary/Chrome), the parts of
 the window, like toolbars, that are not a part of the web page. These are
diff --git a/docs/api/global-shortcut.md b/docs/api/global-shortcut.md
index f20758406b7c..08453d68a46c 100644
--- a/docs/api/global-shortcut.md
+++ b/docs/api/global-shortcut.md
@@ -1,5 +1,7 @@
 # globalShortcut
 
+> Detect keyboard events when the application does not have keyboard focus.
+
 The `globalShortcut` module can register/unregister a global keyboard shortcut
 with the operating system so that you can customize the operations for various
 shortcuts.
diff --git a/docs/api/ipc-main.md b/docs/api/ipc-main.md
index 84fbcfd5a72f..c8ba60ba3170 100644
--- a/docs/api/ipc-main.md
+++ b/docs/api/ipc-main.md
@@ -1,5 +1,7 @@
 # ipcMain
 
+> Communicate asynchronously from the main process to renderer processes.
+
 The `ipcMain` module is an instance of the
 [EventEmitter](https://nodejs.org/api/events.html) class. When used in the main
 process, it handles asynchronous and synchronous messages sent from a renderer
diff --git a/docs/api/ipc-renderer.md b/docs/api/ipc-renderer.md
index 46a2331af43b..9835e42b4679 100644
--- a/docs/api/ipc-renderer.md
+++ b/docs/api/ipc-renderer.md
@@ -1,5 +1,7 @@
 # ipcRenderer
 
+> Communicate asynchronously from a renderer process to the main process.
+
 The `ipcRenderer` module is an instance of the
 [EventEmitter](https://nodejs.org/api/events.html) class. It provides a few
 methods so you can send synchronous and asynchronous messages from the render
diff --git a/docs/api/menu-item.md b/docs/api/menu-item.md
index 1b36432ab297..b67032271e61 100644
--- a/docs/api/menu-item.md
+++ b/docs/api/menu-item.md
@@ -1,7 +1,6 @@
 # MenuItem
 
-The `menu-item` module allows you to add items to an application or context
-[`menu`](menu.md).
+> Add items to native application menus and context menus.
 
 See [`menu`](menu.md) for examples.
 
diff --git a/docs/api/menu.md b/docs/api/menu.md
index cb5a0cbe2df8..4106dfdd4089 100644
--- a/docs/api/menu.md
+++ b/docs/api/menu.md
@@ -1,8 +1,7 @@
 # Menu
 
-The `menu` class is used to create native menus that can be used as
-application menus and
-[context menus](https://developer.mozilla.org/en-US/docs/Mozilla/Tech/XUL/PopupGuide/ContextMenus).
+> Create native application menus and context menus.
+
 This module is a main process module which can be used in a render process via
 the `remote` module.
 
diff --git a/docs/api/native-image.md b/docs/api/native-image.md
index e0c3ae466248..1cbfcf410181 100644
--- a/docs/api/native-image.md
+++ b/docs/api/native-image.md
@@ -1,5 +1,7 @@
 # nativeImage
 
+> Create tray, dock, and application icons using PNG or JPG files.
+
 In Electron, for the APIs that take images, you can pass either file paths or
 `nativeImage` instances. An empty image will be used when `null` is passed.
 
diff --git a/docs/api/power-monitor.md b/docs/api/power-monitor.md
index 4465b253a754..75546dc80159 100644
--- a/docs/api/power-monitor.md
+++ b/docs/api/power-monitor.md
@@ -1,7 +1,8 @@
 # powerMonitor
 
-The `power-monitor` module is used to monitor power state changes. You can
-only use it in the main process. You should not use this module until the `ready`
+> Monitor power state changes.
+
+You can only use it in the main process. You should not use this module until the `ready`
 event of the `app` module is emitted.
 
 For example:
diff --git a/docs/api/power-save-blocker.md b/docs/api/power-save-blocker.md
index a3ef798411f2..3ec07338646b 100644
--- a/docs/api/power-save-blocker.md
+++ b/docs/api/power-save-blocker.md
@@ -1,8 +1,6 @@
 # powerSaveBlocker
 
-The `powerSaveBlocker` module is used to block the system from entering
-low-power (sleep) mode and thus allowing the app to keep the system and screen
-active.
+> Block the system from entering low-power (sleep) mode.
 
 For example:
 
diff --git a/docs/api/process.md b/docs/api/process.md
index 4f13b6972b0c..79bd9bd5572f 100644
--- a/docs/api/process.md
+++ b/docs/api/process.md
@@ -1,5 +1,7 @@
 # process
 
+> Get information about the running application process.
+
 The `process` object in Electron has the following differences from the one in
 upstream node:
 
diff --git a/docs/api/protocol.md b/docs/api/protocol.md
index e57a34ef89b5..aa9b43486d02 100644
--- a/docs/api/protocol.md
+++ b/docs/api/protocol.md
@@ -1,7 +1,6 @@
 # protocol
 
-The `protocol` module can register a custom protocol or intercept an existing
-protocol.
+> Register a custom protocol and intercept existing protocol requests.
 
 An example of implementing a protocol that has the same effect as the
 `file://` protocol:
diff --git a/docs/api/remote.md b/docs/api/remote.md
index 7bdbe0362f60..454758c9139f 100644
--- a/docs/api/remote.md
+++ b/docs/api/remote.md
@@ -1,5 +1,7 @@
 # remote
 
+> Use main process modules from the renderer process.
+
 The `remote` module provides a simple way to do inter-process communication
 (IPC) between the renderer process (web page) and the main process.
 
diff --git a/docs/api/screen.md b/docs/api/screen.md
index 072cd8b435ec..00061e969fbc 100644
--- a/docs/api/screen.md
+++ b/docs/api/screen.md
@@ -1,8 +1,9 @@
 # screen
 
-The `screen` module retrieves information about screen size, displays, cursor
-position, etc. You can not use this module until the `ready` event of the
-`app` module is emitted (by invoking or requiring it).
+> Retrieve information about screen size, displays, cursor position, etc.
+
+You cannot not use this module until the `ready` event of the `app` module is
+emitted (by invoking or requiring it).
 
 `screen` is an [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
 
diff --git a/docs/api/session.md b/docs/api/session.md
index 900301803632..5bc819fb2bde 100644
--- a/docs/api/session.md
+++ b/docs/api/session.md
@@ -1,5 +1,7 @@
 # session
 
+> Manage browser sessions, cookies, cache, proxy settings, etc.
+
 The `session` module can be used to create new `Session` objects.
 
 You can also access the `session` of existing pages by using the `session`
diff --git a/docs/api/shell.md b/docs/api/shell.md
index 823dc481bb07..8ede115f7c63 100644
--- a/docs/api/shell.md
+++ b/docs/api/shell.md
@@ -1,5 +1,7 @@
 # shell
 
+> Manage files and URLs using their default applications.
+
 The `shell` module provides functions related to desktop integration.
 
 An example of opening a URL in the user's default browser:
diff --git a/docs/api/synopsis.md b/docs/api/synopsis.md
index 466b13828c41..a2aa58f57f17 100644
--- a/docs/api/synopsis.md
+++ b/docs/api/synopsis.md
@@ -1,5 +1,7 @@
 # Synopsis
 
+> How to use Node.js and Electron APIs.
+
 All of [Node.js's built-in modules](http://nodejs.org/api/) are available in
 Electron and third-party node modules also fully supported as well (including
 the [native modules](../tutorial/using-native-node-modules.md)).
diff --git a/docs/api/tray.md b/docs/api/tray.md
index aa972c57cd92..1ea0859f14a4 100644
--- a/docs/api/tray.md
+++ b/docs/api/tray.md
@@ -1,7 +1,6 @@
 # Tray
 
-A `Tray` represents an icon in an operating system's notification area, it is
-usually attached with a context menu.
+> Add icons and context menus to the system's notification area.
 
 ```javascript
 const electron = require('electron');
diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index 0eee6c5bf8bb..64e7cea60e79 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -1,8 +1,9 @@
 # webContents
 
+> Render and control web pages.
+
 `webContents` is an
 [EventEmitter](http://nodejs.org/api/events.html#events_class_events_eventemitter).
-
 It is responsible for rendering and controlling a web page and is a property of
 the [`BrowserWindow`](browser-window.md) object. An example of accessing the
 `webContents` object:
diff --git a/docs/api/web-frame.md b/docs/api/web-frame.md
index d9e02ac097e7..b2d8aa0f41eb 100644
--- a/docs/api/web-frame.md
+++ b/docs/api/web-frame.md
@@ -1,7 +1,6 @@
 # webFrame
 
-The `web-frame` module allows you to customize the rendering of the current
-web page.
+> Customize the rendering of the current web page.
 
 An example of zooming current page to 200%.
 
diff --git a/docs/api/web-view-tag.md b/docs/api/web-view-tag.md
index 214f93dbad6f..5f4a422a13a9 100644
--- a/docs/api/web-view-tag.md
+++ b/docs/api/web-view-tag.md
@@ -1,5 +1,7 @@
 # The `<webview>` tag
 
+> Display external web content in an isolated frame and process.
+
 Use the `webview` tag to embed 'guest' content (such as web pages) in your
 Electron app. The guest content is contained within the `webview` container.
 An embedded page within your app controls how the guest content is laid out and
diff --git a/docs/api/window-open.md b/docs/api/window-open.md
index 46e74327741f..abb0760f121e 100644
--- a/docs/api/window-open.md
+++ b/docs/api/window-open.md
@@ -1,5 +1,7 @@
 # The `window.open` function
 
+> 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
 to `window.open` to let the page have limited control over it.