diff --git a/core/modules/user/user.api.php b/core/modules/user/user.api.php
index d0716c90b849789cd4591b2ae6af402df27584a9..6700727ee7eac7dc4baa66d36780e3ccd7d06dd5 100644
--- a/core/modules/user/user.api.php
+++ b/core/modules/user/user.api.php
@@ -107,15 +107,15 @@ function hook_user_cancel_methods_alter(&$methods) {
  *
  * Called by $account->getDisplayName() to allow modules to alter the username
  * that is displayed. Can be used to ensure user privacy in situations where
- * $account->name is too revealing.
+ * $account->getDisplayName() is too revealing.
  *
  * @param string $name
  *   The string that $account->getDisplayName() will return.
  *
  * @param $account
- *   The account object passed to user_format_name().
+ *   The account object the name belongs to.
  *
- * @see $account->getDisplayName()
+ * @see \Drupal\Core\Session\AccountInterface->getDisplayName()
  */
 function hook_user_format_name_alter(&$name, $account) {
   // Display the user's uid instead of name.