diff --git a/core/modules/comment/comment.module b/core/modules/comment/comment.module
index 6bf8a9c..acf9ae9 100644
--- a/core/modules/comment/comment.module
+++ b/core/modules/comment/comment.module
@@ -372,7 +372,7 @@ function comment_permission() {
  * @param int $number
  *   (optional) The maximum number of comments to find. Defaults to 10.
  *
- * @return array
+ * @return \Drupal\comment\CommentInterface[]|array
  *   An array of comment objects or an empty array if there are no recent
  *   comments visible to the current user.
  */
@@ -410,7 +410,7 @@ function comment_get_recent($number = 10) {
  *   The first new comment node.
  *
  * @return array|NULL
- *   Array "page=X" if the page number is greater than zero; NULL otherwise.
+ *   An array "page=X" if the page number is greater than zero; NULL otherwise.
  */
 function comment_new_page_count($num_comments, $new_replies, EntityInterface $node) {
   $mode = variable_get('comment_default_mode_' . $node->getType(), COMMENT_MODE_THREADED);
@@ -693,7 +693,7 @@ function comment_add(EntityInterface $node, $pid = NULL) {
  * @param int $comments_per_page
  *   The amount of comments to display per page.
  *
- * @return array
+ * @return int[]
  *   An array of the IDs of the comment to be displayed.
  *
  * To display threaded comments in the correct order we keep a 'thread' field
diff --git a/core/modules/comment/lib/Drupal/comment/CommentInterface.php b/core/modules/comment/lib/Drupal/comment/CommentInterface.php
index fb9c043..fe7f40d 100644
--- a/core/modules/comment/lib/Drupal/comment/CommentInterface.php
+++ b/core/modules/comment/lib/Drupal/comment/CommentInterface.php
@@ -2,7 +2,7 @@
 
 /**
  * @file
- * Contains \Drupal\comment\Entity\CommentInterface.
+ * Contains \Drupal\comment\CommentInterface.
  */
 
 namespace Drupal\comment;