diff -u b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
--- b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
+++ b/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
@@ -42,14 +42,12 @@
    *   Name of the field being queried. It must contain a field name,
    *   optionally followed by a column name. The column can be "entity" for
    *   reference fields and that can be followed similarly by a field name
-   *   and so on.
-   *
-   *   Some examples:
+   *   and so on. Some examples:
    *   - nid
    *   - tags.value
-   *   - tags this is the same as tags.value as value is the default column.
+   *   - tags
    *   - uid.entity.name
-   *
+   *   "tags" "is the same as "tags.value" as value is the default column.
    *   If two or more conditions have the same field names they apply to the
    *   same delta within that field.
    * @param $value