Issue #3506386 by vargenty, adwivedi008, joachim, quietone: Incomplete docs...

Issue #3506386 by vargenty, adwivedi008, joachim, quietone: Incomplete docs for CommentManagerInterface::getCountNewComments()

core/modules/comment/src/CommentManagerInterface.php

@@ -60,7 +60,7 @@ public function addBodyField($comment_type);
   public function forbiddenMessage(EntityInterface $entity, $field_name);
 
   /**
-   * Returns the number of new comments available on a given entity for a user.
+   * Returns the number of new comments on a given entity for the current user.
    *
    * @param \Drupal\Core\Entity\EntityInterface $entity
    *   The entity to which the comments are attached to.
@@ -71,7 +71,8 @@ public function forbiddenMessage(EntityInterface $entity, $field_name);
    *   entity.
    *
    * @return int|false
-   *   The number of new comments or FALSE if the user is not authenticated.
+   *   The number of new comments or FALSE if the user is not authenticated or
+   *   if the History module is not installed.
    */
   public function getCountNewComments(EntityInterface $entity, $field_name = NULL, $timestamp = 0);