diff --git a/core/lib/Drupal/Core/Entity/Query/Sql/Tables.php b/core/lib/Drupal/Core/Entity/Query/Sql/Tables.php
index 03619eb..ba0c8ea 100644
--- a/core/lib/Drupal/Core/Entity/Query/Sql/Tables.php
+++ b/core/lib/Drupal/Core/Entity/Query/Sql/Tables.php
@@ -235,17 +235,8 @@ public function isFieldCaseSensitive($field_name) {
    * Join entity table if necessary and return the alias for it.
    *
    * @param string $index_prefix
-   *   Table name prefix to discern the same table used in several
-   *   relationships.
-   *   Example:
-   *   When its empty.
-   *   @code
-   *   ->condition('tags', 2, '>')
-   *   @endcode
-   *   When it is node_reference.nid.
-   *   @code
-   *   ->condition('node_reference.nid.entity.tags', 2)
-   *   @endcode
+   *   Prefix that will be put on this table in queries, when it is used within
+   *   this relationship.
    * @param string $property
    *   Mapped field table name.
    * @param string $type
@@ -281,17 +272,8 @@ protected function ensureEntityTable($index_prefix, $property, $type, $langcode,
    * Join field table if necessary.
    *
    * @param string $index_prefix
-   *   Table name prefix to discern the same table used in several
-   *   relationships.
-   *   Example:
-   *   When its empty.
-   *   @code
-   *   ->condition('tags', 2, '>')
-   *   @endcode
-   *   When it is node_reference.nid.
-   *   @code
-   *   ->condition('node_reference.nid.entity.tags', 2)
-   *   @endcode
+   *   Prefix that will be put on this table in queries, when it is used within
+   *   this relationship.
    * @param object $field
    *   A field object.
    * @param string $type