diff --git a/core/modules/user/user.api.php b/core/modules/user/user.api.php
index 48faffb..ac967bf 100644
--- a/core/modules/user/user.api.php
+++ b/core/modules/user/user.api.php
@@ -30,7 +30,7 @@
  *
  * @param array $edit
  *   The array of form values submitted by the user.
- * @param object $account
+ * @param \Drupal\Core\Session\AccountInterface $account
  *   The user object on which the operation is being performed.
  * @param string $method
  *   The account cancellation method.
diff --git a/core/modules/user/user.module b/core/modules/user/user.module
index b0bc699..afc94be 100644
--- a/core/modules/user/user.module
+++ b/core/modules/user/user.module
@@ -636,10 +636,7 @@ function user_user_logout($account) {
  * Generates a unique URL for a user to login and reset their password.
  *
  * @param \Drupal\user\UserInterface $account
- *   An object containing the user account, which must contain at least the
- *   following properties:
- *   - uid: The user ID number.
- *   - login: The UNIX timestamp of the user's last login.
+ *   An object containing the user account.
  * @param array $options
  *   (optional) A keyed array of settings. Supported options are:
  *   - langcode: A language code to be used when generating locale-sensitive
@@ -1029,7 +1026,7 @@ function user_mail_tokens(&$replacements, $data, $options) {
 /*** Administrative features ***********************************************/
 
 /**
- * Retrieve the names of roles matching specified conditions.
+ * Retrieves the names of roles matching specified conditions.
  *
  * @param bool $membersonly
  *   (optional) Set this to TRUE to exclude the 'anonymous' role. Defaults to
@@ -1117,7 +1114,7 @@ function user_user_role_delete(RoleInterface $role) {
  *   (optional) A string containing a permission. If set, only roles containing
  *   that permission are returned. Defaults to NULL, which returns all roles.
  *
- * @return Drupal\user\RoleInterface[]
+ * @return \Drupal\user\RoleInterface[]
  *   An associative array with the role id as the key and the role object as
  *   value.
  */