diff --git a/core/lib/Drupal/Core/Field/FieldItemInterface.php b/core/lib/Drupal/Core/Field/FieldItemInterface.php
index 69906c1..f23395c 100644
--- a/core/lib/Drupal/Core/Field/FieldItemInterface.php
+++ b/core/lib/Drupal/Core/Field/FieldItemInterface.php
@@ -114,11 +114,11 @@ public function getFieldDefinition();
   /**
    * Magic method: Gets a property value.
    *
-   * @param $property_name
+   * @param string $property_name
    *   The name of the property to get; e.g., 'title' or 'name'.
    *
-   * @return \Drupal\Core\TypedData\TypedDataInterface
-   *   The property object.
+   * @return mixed
+   *   The property value.
    *
    * @throws \InvalidArgumentException
    *   If a not existing property is accessed.
@@ -128,9 +128,9 @@ public function __get($property_name);
   /**
    * Magic method: Sets a property value.
    *
-   * @param $property_name
+   * @param string $property_name
    *   The name of the property to set; e.g., 'title' or 'name'.
-   * @param $value
+   * @param mixed $value
    *   The value to set, or NULL to unset the property. Optionally, a typed
    *   data object implementing Drupal\Core\TypedData\TypedDataInterface may be
    *   passed instead of a plain value.
@@ -143,7 +143,7 @@ public function __set($property_name, $value);
   /**
    * Magic method: Determines whether a property is set.
    *
-   * @param $property_name
+   * @param string $property_name
    *   The name of the property to get; e.g., 'title' or 'name'.
    *
    * @return bool
@@ -154,7 +154,7 @@ public function __isset($property_name);
   /**
    * Magic method: Unsets a property.
    *
-   * @param $property_name
+   * @param string $property_name
    *   The name of the property to get; e.g., 'title' or 'name'.
    */
   public function __unset($property_name);
@@ -364,7 +364,7 @@ public static function fieldSettingsFromConfigData(array $settings);
    * @param bool $has_data
    *   TRUE if the field already has data, FALSE if not.
    *
-   * @return
+   * @return array
    *   The form definition for the field settings.
    */
   public function storageSettingsForm(array &$form, FormStateInterface $form_state, $has_data);