diff --git a/core/lib/Drupal/Core/Entity/entity.api.php b/core/lib/Drupal/Core/Entity/entity.api.php
index e07fe62d84..0af0b53232 100644
--- a/core/lib/Drupal/Core/Entity/entity.api.php
+++ b/core/lib/Drupal/Core/Entity/entity.api.php
@@ -74,12 +74,12 @@
  *
  * A revisionable entity can keep track of the changes that affect its data. In
  * fact all previous revisions of the entity can be stored and made available as
- * historical information. The "default" revision is the canonical version of
+ * "historical" information. The "default" revision is the canonical variant 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
  * creation of a new revision, in any other case revision data is not supposed
- * to change. Aside from historical data, there can be "pending" revisions, that
- * contain changes that did not make their way into the default revision.
+ * to change. Aside from historical revisions, there can be "pending" revisions,
+ * that contain changes that did not make their way into the default revision.
  * Typically these revisions contain data that is waiting for some form of
  * approval, before being accepted as canonical.
  * @see \Drupal\Core\Entity\RevisionableInterface
@@ -89,19 +89,19 @@
  * Content entity data is stored via fields, and each field can have one version
  * 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. 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.
+ * "default" translation is the canonical variant of the entity, the one whose
+ * content will be accessible in the entity field data. Other translations
+ * 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
  *
  * 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
+ * canonical variant of the entity is the default translation of the default
  * revision. Any revision will be initially loaded as the default translation,
  * the other revision translations can be instantiated from this one. If a
  * translation has changes in a certain revision, the translation is considered