Issue #3175012 by anagomes, CurriedN, andregp, ptmkenny, longwave, klausi,...

Issue #3175012 by anagomes, CurriedN, andregp, ptmkenny, longwave, klausi, mglaman, acbramley: Update PHPDoc for DataDefinition

(cherry picked from commit 1ee262ed)

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

@@ -78,7 +78,7 @@ public function getLabel() {
   /**
    * Sets the human-readable label.
    *
-   * @param string $label
+   * @param string|\Drupal\Core\StringTranslation\TranslatableMarkup $label
    *   The label to set.
    *
    * @return static
@@ -99,7 +99,7 @@ public function getDescription() {
   /**
    * Sets the human-readable description.
    *
-   * @param string $description
+   * @param string|\Drupal\Core\StringTranslation\TranslatableMarkup $description
    *   The description to set.
    *
    * @return static

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

@@ -57,9 +57,10 @@ public function getDataType();
   /**
    * Returns a human readable label.
    *
-   * @return string|\Drupal\Core\StringTranslation\TranslatableMarkup
+   * @return string|\Drupal\Core\StringTranslation\TranslatableMarkup|null
    *   The label. A string or an instance of TranslatableMarkup will be returned
-   *   based on the way the label translation is handled.
+   *   based on the way the label translation is handled. NULL if no label is
+   *   available.
    */
   public function getLabel();
 
@@ -69,8 +70,10 @@ public function getLabel();
    * Descriptions are usually used on user interfaces where the data is edited
    * or displayed.
    *
-   * @return string|null
-   *   The description, or NULL if no description is available.
+   * @return string|\Drupal\Core\StringTranslation\TranslatableMarkup|null
+   *   The description. A string or an instance of TranslatableMarkup will be
+   *   returned based on the way the description translation is handled. NULL if
+   *   no description is available.
    */
   public function getDescription();