diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index 616f260..8713399 100644
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -256,10 +256,15 @@
 /**
  * Settings:
  *
- * $settings contains configuration that can not be saved in the configuration
- * system because it is required too early during bootstrap like the database
- * information. It is also used for configuration that is specific for a given
- * environment like reverse proxy settings
+ * Settings is one of the methods to supply your Drupal system with
+ * configuration. It is used for environment specific configuration (e.g.
+ * files directory and reverse proxy address) and for temporary overrides (e.g.
+ * twig debugging and security overrides). Use the $settings variable to
+ * override the system defaults.
+ *
+ * Other system configuration determined set in the configuration system, which
+ * can be overridden using the $conf variable as described in the 'Variable
+ * overrides' section below.
  *
  * @see settings_get()
  */