/**
* 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();