diff --git a/core/lib/Drupal/Core/Entity/Query/QueryInterface.php b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
index 8852f0b..dce13d6 100644
--- a/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
+++ b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
@@ -90,7 +90,7 @@ public function getEntityTypeId();
    *   and another does not they are not presumed to apply to the same
    *   translation.
    *
-   * @return \Drupal\Core\Entity\Query\QueryInterface
+   * @return $this
    * @see \Drupal\Core\Entity\Query\andConditionGroup
    * @see \Drupal\Core\Entity\Query\orConditionGroup
    */
@@ -103,7 +103,8 @@ public function condition($field, $value = NULL, $operator = NULL, $langcode = N
    *   Name of a field.
    * @param $langcode
    *   Language code (optional).
-   * @return \Drupal\Core\Entity\Query\QueryInterface
+   *
+   * @return $this
    */
   public function exists($field, $langcode = NULL);
 
@@ -114,7 +115,8 @@ public function exists($field, $langcode = NULL);
    *   Name of a field.
    * @param $langcode
    *   Language code (optional).
-   * @return \Drupal\Core\Entity\Query\QueryInterface
+   *
+   * @return $this
    */
   public function notExists($field, $langcode = NULL);
 
@@ -134,19 +136,31 @@ public function notExists($field, $langcode = NULL);
   public function pager($limit = 10, $element = NULL);
 
   /**
-   * @param null $start
-   * @param null $length
-   * @return \Drupal\Core\Entity\Query\QueryInterface
-   *   The called object.
+   * Defines the range of the query.
+   *
+   * @param int|null $start
+   *   The first record from the result set to return. If NULL, removes any
+   *   range directives that are set.
+   * @param int|null $length
+   *   The maximum number of rows to return. If $start and $length are NULL,
+   *   then complete result is return. If $start is not NULL and $length is
+   *   NULL, then empty result set will be return.
+   *
+   * @return $this
    */
   public function range($start = NULL, $length = NULL);
 
   /**
+   * Sorts the result set by a given field.
+   *
    * @param $field
-   *   Name of a field.
+   *   Name of a field on which to sort.
    * @param string $direction
+   *   The direction to sort. Legal values are "ASC" and "DESC".
+   *   Any other value will be converted to "ASC".
    * @param $langcode
    *   Language code (optional).
+   *
    * @return \Drupal\Core\Entity\Query\QueryInterface
    *   The called object.
    */