diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php
index f8c950b314..c327008410 100644
--- a/src/wp-includes/media.php
+++ b/src/wp-includes/media.php
@@ -2281,14 +2281,17 @@ function wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr ) {
 }
 
 /**
- * The YouTube embed handler callback. Catches URLs that can be parsed but aren't supported by oEmbed.
+ * YouTube embed handler callback.
+ *
+ * Catches URLs that can be parsed but aren't supported by oEmbed.
  *
  * @since 4.0.0
  *
- * @param array $matches The regex matches from the provided regex when calling {@link wp_embed_register_handler()}.
- * @param array $attr Embed attributes.
- * @param string $url The original URL that was matched by the regex.
- * @param array $rawattr The original unmodified attributes.
+ * @param array  $matches The regex matches from the provided regex when calling
+ *                        {@link wp_embed_register_handler()}.
+ * @param array  $attr    Embed attributes.
+ * @param string $url     The original URL that was matched by the regex.
+ * @param array  $rawattr The original unmodified attributes.
  * @return string The embed HTML.
  */
 function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
@@ -2299,6 +2302,8 @@ function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
 	 *
 	 * @since 4.0.0
 	 *
+	 * @see wp_embed_handler_youtube()
+	 *
 	 * @param string $embed   YouTube embed output.
 	 * @param array  $attr    An array of embed attributes.
 	 * @param string $url     The original URL that was matched by the regex.
@@ -3232,8 +3237,9 @@ function wp_maybe_generate_attachment_metadata( $attachment ) {
  * @since 4.0.0
  *
  * @global wpdb $wpdb WordPress database access abstraction object.
+ *
  * @param string $url The URL to resolve.
- * @return int The found post_id.
+ * @return int The found post ID.
  */
 function attachment_url_to_postid( $url ) {
 	global $wpdb;