diff --git a/core/lib/Drupal/Core/Config/ConfigEvents.php b/core/lib/Drupal/Core/Config/ConfigEvents.php
index 8589565..dd60540 100644
--- a/core/lib/Drupal/Core/Config/ConfigEvents.php
+++ b/core/lib/Drupal/Core/Config/ConfigEvents.php
@@ -10,7 +10,6 @@
 /**
  * Defines events for the configuration system.
  *
- *
  * @see \Drupal\Core\Config\ConfigCrudEvent
  */
 final class ConfigEvents {
@@ -25,10 +24,10 @@
    * This event will be fired when configuration is saved by hook_update_N()
    * implementations. Subscribers to this event can not make any assumption that
    * the config data is valid and should ensure that their actions are safe
-   * regardless of the structure of the underlying configuration.
-   * Implementations must use the $trusted_data argument for
-   * \Drupal\Core\Config\Config::save() and pass schema correct data so that
-   * configuration schema are not used whilst saving configuration.
+   * regardless of the structure of the underlying configuration. When changing
+   * configuration values, the value must be the correct data type.
+   * Configuration must be saved with the $trusted_data flag set to TRUE so that
+   * configuration schema are not used.
    *
    * @Event
    *
@@ -51,10 +50,10 @@
    * This event will be fired when configuration is deleted by hook_update_N()
    * implementations. Subscribers to this event can not make any assumption that
    * the config data is valid and should ensure that their actions are safe
-   * regardless of the structure of the underlying configuration.
-   * Implementations must use the $trusted_data argument for
-   * \Drupal\Core\Config\Config::save() and pass schema correct data so that
-   * configuration schema are not used whilst saving configuration.
+   * regardless of the structure of the underlying configuration. When changing
+   * configuration values, the value must be the correct data type.
+   * Configuration must be saved with the $trusted_data flag set to TRUE so that
+   * configuration schema are not used.
    *
    * @Event
    *
@@ -77,10 +76,10 @@
    * This event will be fired when configuration is renamed by hook_update_N()
    * implementations. Subscribers to this event can not make any assumption that
    * the config data is valid and should ensure that their actions are safe
-   * regardless of the structure of the underlying configuration.
-   * Implementations must use the $trusted_data argument for
-   * \Drupal\Core\Config\Config::save() and pass schema correct data so that
-   * configuration schema are not used whilst saving configuration.
+   * regardless of the structure of the underlying configuration. When changing
+   * configuration values, the value must be the correct data type.
+   * Configuration must be saved with the $trusted_data flag set to TRUE so that
+   * configuration schema are not used.
    *
    * @Event
    *