From 4657466d125dd7fb5eb1ccbc9d989528d8abba25 Mon Sep 17 00:00:00 2001
From: quietone <quietone@2572884.no-reply.drupal.org>
Date: Fri, 11 Mar 2022 21:11:03 +0000
Subject: [PATCH] Issue #3226716 by beatrizrodrigues, joachim, xjm,
 lucienchalom: Missing return value documentation for
 TranslatableInterface::addTranslation()

---
 core/lib/Drupal/Core/TypedData/TranslatableInterface.php | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/core/lib/Drupal/Core/TypedData/TranslatableInterface.php b/core/lib/Drupal/Core/TypedData/TranslatableInterface.php
index 00d9f657935..7aa0cb19731 100644
--- a/core/lib/Drupal/Core/TypedData/TranslatableInterface.php
+++ b/core/lib/Drupal/Core/TypedData/TranslatableInterface.php
@@ -69,7 +69,7 @@ interface TranslatableInterface {
    *   LanguageInterface::LANGCODE_DEFAULT
    *   to get the data in default language.
    *
-   * @return $this
+   * @return \Drupal\Core\Entity\ContentEntityInterface
    *   A typed data object for the translated data.
    *
    * @throws \InvalidArgumentException
@@ -80,7 +80,8 @@ interface TranslatableInterface {
   /**
    * Returns the translatable object in the language it was created.
    *
-   * @return $this
+   * @return \Drupal\Core\Entity\ContentEntityInterface
+   *   The translation object referring to the original language.
    */
   public function getUntranslated();
 
@@ -109,7 +110,8 @@ interface TranslatableInterface {
    *   (optional) An array of initial values to be assigned to the translatable
    *   fields. Defaults to none.
    *
-   * @return $this
+   * @return \Drupal\Core\Entity\ContentEntityInterface
+   *   A new entity translation object.
    *
    * @throws \InvalidArgumentException
    *   If an invalid or existing translation language is specified.