diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index 616f260..3b8b493 100644
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -256,12 +256,11 @@
 /**
  * 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 contains configuration to set or override environment specific
+ * configuration such as files directory and reverse proxy address, and for
+ * temporary overrides like twig debugging and security overrides.
  *
- * @see settings_get()
+ * @see Settings::get()
  */
 
 /**