diff --git a/core/modules/user/user.api.php b/core/modules/user/user.api.php
index 124617b212..839b973ead 100644
--- a/core/modules/user/user.api.php
+++ b/core/modules/user/user.api.php
@@ -120,12 +120,11 @@ function hook_user_cancel_methods_alter(&$methods) {
  *   values will be autoescaped.
  * @param \Drupal\Core\Session\AccountInterface $account
  *   The object on which the operation is being performed. This object may be a
- *   user entity or current user session object. If the object is implementation
- *   of UserInterface you can use instanceof operator before accessing user
- *   entity method. For example:
+ *   user entity. If the object is an implementation of UserInterface you can
+ *   use instanceof operator before accessing user entity method. For example:
  *   @code
  *     if ($account instanceof UserInterface) {
- *        // Access user object methods.
+ *        // Access user entity methods.
  *     }
  *   @endcode
  *