diff --git a/CHANGELOG.md b/CHANGELOG.md
index e9c83bd70..8b7c25eb2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ CHANGELOG
 * @DaveVoyles updated URL to player API docs ([view](https://github.com/videojs/video.js/pull/2685))
 * @ ([view](https://github.com/videojs/video.js/pull/2691))
 * @kahwee Fixed sandbox plugin example to work in Video.js 5 ([view](https://github.com/videojs/video.js/pull/2691))
+* @Soviut Fixed argument names in some API docs ([view](https://github.com/videojs/video.js/pull/2714))
 
 --------------------
 
diff --git a/src/js/video.js b/src/js/video.js
index 2310dfc79..15f7ee7e0 100644
--- a/src/js/video.js
+++ b/src/js/video.js
@@ -282,9 +282,9 @@ videojs.extend = extendFn;
  *     // result.bar.b = [4,5,6];
  * ```
  *
- * @param {Object} The options object whose values will be overriden
- * @param {Object} The options object with values to override the first
- * @param {Object} Any number of additional options objects
+ * @param {Object} defaults  The options object whose values will be overriden
+ * @param {Object} overrides The options object with values to override the first
+ * @param {Object} etc       Any number of additional options objects
  *
  * @return {Object} a new object with the merged values
  * @mixes videojs
@@ -349,8 +349,8 @@ videojs.bind = Fn.bind;
  *     // --> Should alert 'Plugin added later!'
  * ```
  *
- * @param {String} The plugin name
- * @param {Function} The plugin function that will be called with options
+ * @param {String} name The plugin name
+ * @param {Function} fn The plugin function that will be called with options
  * @mixes videojs
  * @method plugin
  */