diff --git a/docs/api/shell.md b/docs/api/shell.md
index f2b4ad3ba88..3f220199d96 100644
--- a/docs/api/shell.md
+++ b/docs/api/shell.md
@@ -78,7 +78,9 @@ returned, otherwise `false` is returned.
 
 ### `shell.readShortcutLink(shortcutPath)` _Windows_
 
-Resolves the shortcut link at `shortcutPath`, an object is returned with the
+- `shortcutPath` String
+
+Resolves the shortcut link at `shortcutPath`. An object is returned with the
 fields described in the `options` of `shell.writeShortcutLink`.
 
 An exception will be thrown when any error happens.
diff --git a/docs/api/tray.md b/docs/api/tray.md
index 7ea8a4835cf..172bd9e21f6 100644
--- a/docs/api/tray.md
+++ b/docs/api/tray.md
@@ -185,11 +185,11 @@ Sets the title displayed aside of the tray icon in the status bar.
 
 #### `tray.setHighlightMode(mode)` _macOS_
 
-* `mode` String highlight mode with one of the following values:
-  * `'selection'` - Highlight the tray icon when it is clicked and also when
+* `mode` String - highlight mode with one of the following values:
+  * `selection` - Highlight the tray icon when it is clicked and also when
     its context menu is open. This is the default.
-  * `'always'` - Always highlight the tray icon.
-  * `'never'` - Never highlight the tray icon.
+  * `always` - Always highlight the tray icon.
+  * `never` - Never highlight the tray icon.
 
 Sets when the tray's icon background becomes highlighted (in blue).
 
diff --git a/docs/api/web-contents.md b/docs/api/web-contents.md
index 78f83d6b5a3..d441ddc4bcc 100644
--- a/docs/api/web-contents.md
+++ b/docs/api/web-contents.md
@@ -1128,6 +1128,8 @@ If *offscreen rendering* is enabled returns whether it is currently painting.
 
 #### `contents.setFrameRate(fps)`
 
+* `fps` Integer
+
 If *offscreen rendering* is enabled sets the frame rate to the specified number.
 Only values between 1 and 60 are accepted.