diff --git a/core/lib/Drupal/Core/Entity/entity.api.php b/core/lib/Drupal/Core/Entity/entity.api.php index 1277786f6e..e07fe62d84 100644 --- a/core/lib/Drupal/Core/Entity/entity.api.php +++ b/core/lib/Drupal/Core/Entity/entity.api.php @@ -73,7 +73,7 @@ * it can be revisionable, translatable, or both. * * A revisionable entity can keep track of the changes that affect its data. In - * fact all previous revisions of the entity are stored and available as + * fact all previous revisions of the entity can be stored and made available as * historical information. The "default" revision is the canonical version of * the entity, the one that is loaded when no specific revision is requested. * Only changes to the default revision may be performed without triggering the @@ -90,10 +90,12 @@ * for each enabled language. Some fields may be defined as untranslatable, * which means that their values are 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. Every translation has an "active language" that is used to determine - * which field translation values should be handled. + * content will be accessible in the entity field data. Other translation + * objects can be instantiated from the default one. Every translation has an + * "active language" that is used to determine which field translation values + * should be handled. Typically the default translation's active language is the + * language of the content that was originally entered and served as source for + * the other translations. * @see \Drupal\Core\Entity\TranslatableInterface * @see \Drupal\Core\Entity\TranslatableStorageInterface *