diff --git a/core/lib/Drupal/Core/Entity/entity.api.php b/core/lib/Drupal/Core/Entity/entity.api.php index 4d63072e02..ee100687a6 100644 --- a/core/lib/Drupal/Core/Entity/entity.api.php +++ b/core/lib/Drupal/Core/Entity/entity.api.php @@ -91,16 +91,17 @@ * is shared among all translations. The "default" translation is the canonical * version of the entity, the one whose content will be accessible in the entity * field data, if no language is specified. Other translation objects can be - * instantiated from the default one. A translation is identified by the entity - * identifier and the "active language". See - * \Drupal\Core\Entity\TranslatableInterface and + * instantiated from the default one. Every translation has an "active language" + * that is used to determine which field translation values should be handled. + * See \Drupal\Core\Entity\TranslatableInterface and * \Drupal\Core\Entity\TranslatableStorageInterface for more details. * * An entity that is both revisionable and translatable has all the features * described above: every revision can contain one or more translations. The * canonical version of the entity is the default translation of the default - * revision. If a translation has changes in a certain revision, the translation - * is considered "affected" by that revision. With the built-in UI a translation + * revision. Any revision will be initially loaded as the default translation. + * If a translation has changes in a certain revision, the translation is + * considered "affected" by that revision. With the built-in UI a translation * change will create a new revision (with a copy of all field data for other * translations), unless the default revision is being modified (no new revision * is created). In this case, multiple translations may be affected by the