diff --git a/src/wp-includes/class-wp-oembed.php b/src/wp-includes/class-wp-oembed.php
index 881de68103..a74540d55b 100644
--- a/src/wp-includes/class-wp-oembed.php
+++ b/src/wp-includes/class-wp-oembed.php
@@ -247,8 +247,14 @@ class WP_oEmbed {
 	 *
 	 * @see WP_oEmbed::discover()
 	 *
-	 * @param string       $url  The URL to the content.
-	 * @param string|array $args Optional provider arguments.
+	 * @param string       $url      The URL to the content.
+	 * @param string|array $args     {
+	 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+	 *
+	 *     @type bool $discover Optional. Determines whether to attempt to discover link tags at the given URL
+	 *                          for an oEmbed provider when the oEmbed provider URL is not found in the
+	 *                          built-in providers list.
+	 * }
 	 * @return string|false The oEmbed provider URL on success, false on failure.
 	 */
 	public function get_provider( $url, $args = '' ) {
@@ -338,8 +344,16 @@ class WP_oEmbed {
 	 *
 	 * @since 4.8.0
 	 *
-	 * @param string       $url  The URL to the content that should be attempted to be embedded.
-	 * @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty.
+	 * @param string       $url      The URL to the content that should be attempted to be embedded.
+	 * @param string|array $args     {
+	 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+	 *
+	 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+	 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+	 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+	 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+	 *                                   built-in providers list.
+	 * }
 	 * @return object|false The result in the form of an object on success, false on failure.
 	 */
 	public function get_data( $url, $args = '' ) {
@@ -363,13 +377,22 @@ class WP_oEmbed {
 	/**
 	 * The do-it-all function that takes a URL and attempts to return the HTML.
 	 *
-	 * @see WP_oEmbed::fetch()
+	 * @since 2.9.0
+	 *
 	 * @see WP_oEmbed::data2html()
 	 *
-	 * @since 2.9.0
+	 * @see WP_oEmbed::fetch()
+	 *
+	 * @param string       $url      The URL to the content that should be attempted to be embedded.
+	 * @param string|array $args     {
+	 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
 	 *
-	 * @param string       $url  The URL to the content that should be attempted to be embedded.
-	 * @param array|string $args Optional. Arguments, usually passed from a shortcode. Default empty.
+	 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+	 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+	 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+	 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+	 *                                   built-in providers list.
+	 * }
 	 * @return string|false The UNSANITIZED (and potentially unsafe) HTML that should be used to embed on success,
 	 *                      false on failure.
 	 */
@@ -385,10 +408,18 @@ class WP_oEmbed {
 		 *
 		 * @since 4.5.3
 		 *
-		 * @param null|string $result The UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
-		 *                            Default null to continue retrieving the result.
-		 * @param string      $url    The URL to the content that should be attempted to be embedded.
-		 * @param array       $args   Optional. Arguments, usually passed from a shortcode. Default empty.
+		 * @param null|string  $result   The UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
+		 *                               Default null to continue retrieving the result.
+		 * @param string       $url      The URL to the content that should be attempted to be embedded.
+		 * @param string|array $args     {
+		 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+		 *
+		 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+		 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+		 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+		 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+		 *                                   built-in providers list.
+		 * }
 		 */
 		$pre = apply_filters( 'pre_oembed_result', null, $url, $args );
 
@@ -407,9 +438,17 @@ class WP_oEmbed {
 		 *
 		 * @since 2.9.0
 		 *
-		 * @param string|false $data The returned oEmbed HTML (false if unsafe).
-		 * @param string       $url  URL of the content to be embedded.
-		 * @param array        $args Optional arguments, usually passed from a shortcode.
+		 * @param string|false $data     The returned oEmbed HTML (false if unsafe).
+		 * @param string       $url      URL of the content to be embedded.
+		 * @param string|array $args     {
+		 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+		 *
+		 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+		 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+		 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+		 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+		 *                                   built-in providers list.
+		 * }
 		 */
 		return apply_filters( 'oembed_result', $this->data2html( $data, $url ), $url, $args );
 	}
@@ -511,7 +550,15 @@ class WP_oEmbed {
 	 *
 	 * @param string       $provider The URL to the oEmbed provider.
 	 * @param string       $url      The URL to the content that is desired to be embedded.
-	 * @param array|string $args     Optional. Arguments, usually passed from a shortcode. Default empty.
+	 * @param string|array $args     {
+	 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+	 *
+	 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+	 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+	 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+	 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+	 *                                   built-in providers list.
+	 * }
 	 * @return object|false The result in the form of an object on success, false on failure.
 	 */
 	public function fetch( $provider, $url, $args = '' ) {
@@ -528,9 +575,17 @@ class WP_oEmbed {
 		 * @since 2.9.0
 		 * @since 4.9.0 The `dnt` (Do Not Track) query parameter was added to all oEmbed provider URLs.
 		 *
-		 * @param string $provider URL of the oEmbed provider.
-		 * @param string $url      URL of the content to be embedded.
-		 * @param array  $args     Optional arguments, usually passed from a shortcode.
+		 * @param string $provider       URL of the oEmbed provider.
+		 * @param string $url            URL of the content to be embedded.
+		 * @param string|array $args     {
+		 *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+		 *
+		 *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+		 *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+		 *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+		 *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+		 *                                   built-in providers list.
+		 * }
 		 */
 		$provider = apply_filters( 'oembed_fetch_url', $provider, $url, $args );
 
diff --git a/src/wp-includes/embed.php b/src/wp-includes/embed.php
index a9704b7872..0eeef7f612 100644
--- a/src/wp-includes/embed.php
+++ b/src/wp-includes/embed.php
@@ -98,9 +98,16 @@ function wp_embed_defaults( $url = '' ) {
  *
  * @see WP_oEmbed
  *
- * @param string $url  The URL that should be embedded.
- * @param array  $args Optional. Additional arguments and parameters for retrieving embed HTML.
- *                     Default empty.
+ * @param string       $url      The URL that should be embedded.
+ * @param string|array $args     {
+ *     Optional. Additional arguments and parameters for retrieving embed HTML. Default empty.
+ *
+ *     @type int|string    $width    Optional. The "maxwidth" value passed to the provider URL.
+ *     @type int|string    $height   Optional. The "maxheight" value passed to the provider URL.
+ *     @type bool          $discover Optional. Determines whether to attempt to discover link tags at the given URL
+ *                                   for an oEmbed provider when the oEmbed provider URL is not found in the
+ *                                   built-in providers list.
+ * }
  * @return string|false The embed HTML on success, false on failure.
  */
 function wp_oembed_get( $url, $args = '' ) {