diff --git a/docs/api/session.md b/docs/api/session.md
index a6e89a647d8a..34fd8c481d54 100644
--- a/docs/api/session.md
+++ b/docs/api/session.md
@@ -26,7 +26,7 @@ The `session` module has the following methods:
 ### `session.fromPartition(partition[, options])`
 
 * `partition` String
-* `options` Object
+* `options` Object (optional)
   * `cache` Boolean - Whether to enable cache.
 
 Returns `Session` - A session instance from `partition` string. When there is an existing
diff --git a/docs/api/webview-tag.md b/docs/api/webview-tag.md
index f4445872d01c..5fcc3bffd4e6 100644
--- a/docs/api/webview-tag.md
+++ b/docs/api/webview-tag.md
@@ -402,10 +402,10 @@ Returns `String` - The user agent for guest page.
 
 Injects CSS into the guest page.
 
-### `<webview>.executeJavaScript(code, userGesture, callback)`
+### `<webview>.executeJavaScript(code[, userGesture, callback])`
 
 * `code` String
-* `userGesture` Boolean - Default `false`.
+* `userGesture` Boolean (optional) - Default `false`.
 * `callback` Function (optional) - Called after script has been executed.
   * `result` Any