diff --git a/core/lib/Drupal/Core/Session/AccountProxyInterface.php b/core/lib/Drupal/Core/Session/AccountProxyInterface.php
index 378b89dbf8b038cd3ec1f13fdf94359dd5525c20..0b437ab793ee448fef589c8307a005461c6fa3dd 100644
--- a/core/lib/Drupal/Core/Session/AccountProxyInterface.php
+++ b/core/lib/Drupal/Core/Session/AccountProxyInterface.php
@@ -5,6 +5,11 @@
 /**
  * Defines an interface for a service which has the current account stored.
  *
+ * It is generally more useful to use \Drupal\Core\Session\AccountInterface
+ * unless one specifically needs the proxying features of this interface.
+ *
+ * @see \Drupal\Core\Session\AccountInterface
+ *
  * @ingroup user_api
  */
 interface AccountProxyInterface extends AccountInterface {