diff --git a/core/core.api.php b/core/core.api.php
index fc42a72..233d74b 100644
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -315,17 +315,16 @@
  * @code
  * $config =\Drupal::service('config.factory')->getEditable('mymodule.foo');
  * @endcode
- * Configuration is changed or added using the set() method and saved using the
- * save() method:
+ *
+ * Individual configuration values can be changed or added using the set()
+ * method:
  * @code
  * // Set a scalar value.
  * $config->set('enabled', 1);
- * // Save the configuration.
- * $config->save();
  * @endcode
  *
- * Individual configuration values can be unset using the clear() function,
- * which is also chainable:
+ * Configuration values can also be unset using the clear() method, which is
+ * also chainable:
  * @code
  * $config->clear('bar.boo')->save();
  * $config_data = $config->get('bar');
@@ -333,6 +332,12 @@
  * In this example $config_data would return an array with one key - 'baz' -
  * because 'boo' was unset.
  *
+ * Finally, all changes can then be saved using the save() method:
+ * @code
+ * // Save the configuration.
+ * $config->save();
+ * @endcode
+ *
  * @section sec_entity Configuration entities
  * In contrast to the simple configuration settings described in the previous
  * section, if your module allows users to create zero or more items (where