Issue #3269177: Should some TranslatableInterface methods return ContentEntityInterface or TranslatableRevisionableInterface

core/lib/Drupal/Core/TypedData/TranslatableInterface.php

@@ -69,7 +69,7 @@ public function getTranslationLanguages($include_default = TRUE);
    *   LanguageInterface::LANGCODE_DEFAULT
    *   to get the data in default language.
    *
-   * @return \Drupal\Core\Entity\ContentEntityInterface
+   * @return static
    *   A typed data object for the translated data.
    *
    * @throws \InvalidArgumentException
@@ -80,7 +80,7 @@ public function getTranslation($langcode);
   /**
    * Returns the translatable object in the language it was created.
    *
-   * @return \Drupal\Core\Entity\ContentEntityInterface
+   * @return static
    *   The translation object referring to the original language.
    */
   public function getUntranslated();
@@ -110,7 +110,7 @@ public function hasTranslation($langcode);
    *   (optional) An array of initial values to be assigned to the translatable
    *   fields. Defaults to none.
    *
-   * @return \Drupal\Core\Entity\ContentEntityInterface
+   * @return static
    *   A new entity translation object.
    *
    * @throws \InvalidArgumentException