diff --git a/src/wp-includes/embed-functions.php b/src/wp-includes/embed-functions.php
index ba8b08df57..24604c1faa 100644
--- a/src/wp-includes/embed-functions.php
+++ b/src/wp-includes/embed-functions.php
@@ -43,7 +43,7 @@ function wp_embed_unregister_handler( $id, $priority = 10 ) {
 }
 
 /**
- * Create default array of embed parameters.
+ * Creates default array of embed parameters.
  *
  * The width defaults to the content width as specified by the theme. If the
  * theme does not specify a content width, then 500px is used.
@@ -74,9 +74,9 @@ function wp_embed_defaults( $url = '' ) {
 	 *
 	 * @since 2.9.0
 	 *
-	 * @param int    $width  Width of the embed in pixels.
-	 * @param int    $height Height of the embed in pixels.
-	 * @param string $url    The URL that should be embedded.
+	 * @param array  $size An array of embed width and height values
+	 *                     in pixels (in that order).
+	 * @param string $url  The URL that should be embedded.
 	 */
 	return apply_filters( 'embed_defaults', compact( 'width', 'height' ), $url );
 }