diff -u b/core/lib/Drupal/Core/Entity/EntityHandlerBase.php b/core/lib/Drupal/Core/Entity/EntityHandlerBase.php
--- b/core/lib/Drupal/Core/Entity/EntityHandlerBase.php
+++ b/core/lib/Drupal/Core/Entity/EntityHandlerBase.php
@@ -15,8 +15,7 @@
  * Provides a base class for entity handlers.
  *
  * @deprecated in Drupal 8.0.x, will be removed before Drupal 9.0.0.
- *
- * @see \Drupal\Core\Entity\EntityHandlerInterface
+ *   Use \Drupal\Core\Entity\EntityHandlerInterface::createInstance().
  */
 abstract class EntityHandlerBase {
   use StringTranslationTrait;