Issue #3001851 by abramm, longwave: Incorrect documented...

Issue #3001851 by abramm, longwave: Incorrect documented CommentInterface::getCommentedEntity() return value

core/modules/comment/src/CommentInterface.php

@@ -56,8 +56,9 @@ public function getParentComment();
   /**
    * Returns the entity to which the comment is attached.
    *
-   * @return \Drupal\Core\Entity\FieldableEntityInterface
-   *   The entity on which the comment is attached.
+   * @return \Drupal\Core\Entity\FieldableEntityInterface|null
+   *   The entity on which the comment is attached or NULL if the comment is an
+   *   orphan.
    */
   public function getCommentedEntity();