diff --git a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
index f3fddf6..9877c2d 100644
--- a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
+++ b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/Field.php
@@ -369,7 +369,6 @@ public function save() {
       // Tell the storage engine to update the field by invoking the
       // hook_field_storage_update_field(). Do this before saving the
       // new definition since it still might fail.
-      // @todo Clarify.
       $module_handler->invoke($this->storage['module'], 'field_storage_update_field', array($this, $original, $has_data));
 
       $hook = 'field_update_field';
diff --git a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
index 41d4441..a8035ca 100644
--- a/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
+++ b/core/modules/field/lib/Drupal/field/Plugin/Core/Entity/FieldInstance.php
@@ -346,7 +346,7 @@ public function save() {
         throw new FieldException("Cannot change an existing instance's entity_type.");
       }
       // Renaming a bundle on the instance is allowed when an entity's bundle
-      // is renamed and when field_attach_rename_bundle() does internal
+      // is renamed and when field_entity_bundle_rename() does internal
       // housekeeping.
       if ($this->bundle != $original->bundle && !isset($this->bundle_rename_allowed)) {
         throw new FieldException("Cannot change an existing instance's bundle.");
@@ -369,7 +369,7 @@ public function save() {
       'type' => $field_type_info['default_widget'],
       'settings' => array(),
     );
-    // Check widget module.
+    // Get the widget module and settings from the widget type.
     if ($widget_type_info = \Drupal::service('plugin.manager.field.widget')->getDefinition($this->widget['type'])) {
       $this->widget['module'] = $widget_type_info['module'];
       $this->widget['settings'] += $widget_type_info['settings'];