diff --git a/src/wp-includes/user.php b/src/wp-includes/user.php
index abdb6dc7a5..76f5df4d33 100644
--- a/src/wp-includes/user.php
+++ b/src/wp-includes/user.php
@@ -2220,24 +2220,24 @@ All at ###SITENAME###
 			);
 
 			/**
-			 * Filter the email sent when the user's password is changed.
+			 * Filter the contents of the email sent when the user's password is changed.
 			 *
 			 * @since 4.3.0
 			 *
 			 * @param array $pass_change_email {
-			 *            Used to build wp_mail(). https://developer.wordpress.org/reference/functions/wp_mail/
+			 *            Used to build wp_mail().
 			 *            @type string $to      The intended recipients. Add emails in a comma separated string.
 			 *            @type string $subject The subject of the email.
 			 *            @type string $message The content of the email.
 			 *                The following strings have a special meaning and will get replaced dynamically:
-			 *                ###USERNAME###    The current user's username.
-			 *                ###ADMIN_EMAIL### The admin email in case this was unexpected.
-			 *                ###EMAIL###       The old email.
-			 *                ###SITENAME###    The name of the site.
-			 *                ###SITEURL###     The URL to the site.
-			 *            @type  string $headers Headers. Add headers in a newline (\r\n) separated string.
+			 *                - ###USERNAME###    The current user's username.
+			 *                - ###ADMIN_EMAIL### The admin email in case this was unexpected.
+			 *                - ###EMAIL###       The old email.
+			 *                - ###SITENAME###    The name of the site.
+			 *                - ###SITEURL###     The URL to the site.
+			 *            @type string $headers Headers. Add headers in a newline (\r\n) separated string.
 			 *        }
-			 * @param array $user The original user array.
+			 * @param array $user     The original user array.
 			 * @param array $userdata The updated user array.
 			 *
 			 */