diff --git a/core/lib/Drupal/Core/Entity/entity.api.php b/core/lib/Drupal/Core/Entity/entity.api.php
index ee100687a6..8299076068 100644
--- a/core/lib/Drupal/Core/Entity/entity.api.php
+++ b/core/lib/Drupal/Core/Entity/entity.api.php
@@ -81,9 +81,9 @@
  * to change. Aside from historical data, 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 and
- * \Drupal\Core\Entity\RevisionableStorageInterface for more details.
+ * approval, before being accepted as canonical.
+ * @see \Drupal\Core\Entity\RevisionableInterface
+ * @see \Drupal\Core\Entity\RevisionableStorageInterface
  *
  * A translatable entity can contain multiple translations of the same content.
  * Content entity data is stored via fields, and each field can have one version
@@ -93,23 +93,25 @@
  * 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.
- * See \Drupal\Core\Entity\TranslatableInterface and
- * \Drupal\Core\Entity\TranslatableStorageInterface for more details.
+ * @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
- * 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
- * default revision. Pending revisions are not supposed to contain multiple
- * affected translations, even when they are being manipulated via the API. See
- * \Drupal\Core\Entity\TranslatableRevisionableInterface and
- * \Drupal\Core\Entity\TranslatableRevisionableStorageInterface for more
- * details.
+ * 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
+ * "affected" by that revision. With the built-in UI, every time a new revision
+ * is saved, the changes for the edited translations will be stored, while all
+ * field values for the other translations will be copied as-is. However, if the
+ * default revision is being modified without creating a new revision, multiple
+ * translations can be changed. In this case, multiple translations may be
+ * affected by the default revision. On the other hand, pending revisions are
+ * not supposed to contain multiple affected translations, even when they are
+ * being manipulated via the API.
+ * @see \Drupal\Core\Entity\TranslatableRevisionableInterface
+ * @see \Drupal\Core\Entity\TranslatableRevisionableStorageInterface
  *
  * @section create Create operations
  * To create an entity: