diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index 73d53ed875c3..f528902af6eb 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -985,7 +985,7 @@ The `flags` is an array that can include following `String`s:
 
 #### `win.setThumbnailClip(region)` _Windows_
 
-* `region` - Object
+* `region` Object - Region of the window
   * `x` Integer - x-position of region
   * `y` Integer - y-position of region
   * `width` Integer - width of region
diff --git a/docs/api/session.md b/docs/api/session.md
index 527effc4d0b6..ca9f9ad29236 100644
--- a/docs/api/session.md
+++ b/docs/api/session.md
@@ -20,7 +20,7 @@ const ses = win.webContents.session
 
 The `session` module has the following methods:
 
-### session.fromPartition(partition[, options])
+### `session.fromPartition(partition[, options])`
 
 * `partition` String
 * `options` Object
@@ -43,7 +43,7 @@ of an existing `Session` object.
 
 The `session` module has the following properties:
 
-### session.defaultSession
+### `session.defaultSession`
 
 Returns the default session object of the app.
 
diff --git a/docs/api/system-preferences.md b/docs/api/system-preferences.md
index 586422e56654..91b2951c6ed9 100644
--- a/docs/api/system-preferences.md
+++ b/docs/api/system-preferences.md
@@ -43,9 +43,7 @@ Removes the subscriber with `id`.
 ### `systemPreferences.subscribeLocalNotification(event, callback)` _macOS_
 
 Same as `subscribeNotification`, but uses `NSNotificationCenter` for local defaults.
-This is necessary for events such as:
-
-* `NSUserDefaultsDidChangeNotification`
+This is necessary for events such as `NSUserDefaultsDidChangeNotification`
 
 ### `systemPreferences.unsubscribeLocalNotification(id)` _macOS_
 
diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index 714d61eced95..fb3e42d79d04 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -850,7 +850,6 @@ Opens the developer tools for the service worker context.
 #### `contents.send(channel[, arg1][, arg2][, ...])`
 
 * `channel` String
-* `arg` (optional)
 
 Send an asynchronous message to renderer process via `channel`, you can also
 send arbitrary arguments. Arguments will be serialized in JSON internally and
@@ -893,8 +892,8 @@ app.on('ready', () => {
 
 * `screenPosition` String - Specify the screen type to emulate
     (default: `desktop`)
-  * `desktop`
-  * `mobile`
+  * `desktop` - Desktop screen type
+  * `mobile` - Mobile screen type
 * `screenSize` Object - Set the emulated screen size (screenPosition == mobile)
   * `width` Integer - Set the emulated screen width
   * `height` Integer - Set the emulated screen height