Issue #2936253 by gabesullice: Clarify usage of AccountProxyInterface:...

Issue #2936253 by gabesullice: Clarify usage of AccountProxyInterface: recommend AccountInterface for most use cases

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 {