diff --git a/core/lib/Drupal/Core/Field/FieldItemInterface.php b/core/lib/Drupal/Core/Field/FieldItemInterface.php
index 693a39a29f0d33bd018cc40ed2695e8fc615909b..cba5653e45a13bf91bbb48d8f2bf500d3c96015c 100644
--- a/core/lib/Drupal/Core/Field/FieldItemInterface.php
+++ b/core/lib/Drupal/Core/Field/FieldItemInterface.php
@@ -176,24 +176,24 @@ public function view($display_options = array());
   /**
    * Defines custom presave behavior for field values.
    *
-   * This method is called before either insert() or update() methods, and
-   * before values are written into storage.
+   * This method is called before insert() and update() methods, and before
+   * values are written into storage.
    */
   public function preSave();
 
   /**
    * Defines custom insert behavior for field values.
    *
-   * This method is called after the save() method, and before values are
-   * written into storage.
+   * This method is called during the process of inserting an entity, just
+   * before values are written into storage.
    */
   public function insert();
 
   /**
    * Defines custom update behavior for field values.
    *
-   * This method is called after the save() method, and before values are
-   * written into storage.
+   * This method is called during the process of updating an entity, just before
+   * values are written into storage.
    */
   public function update();