diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index b6eec05..864654e 100644
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -286,12 +286,16 @@
 /**
  * Twig debugging:
  *
- * Add debugging information in HTML comments surrounding the markup produced by
- * each Twig template; Enable the use of the 'dump' function in Twig templates
- * to output information about template variables; automatically recompile Twig
- * templates whenever the source code changes.
- *
- * @see http://drupal.org/node/1906392
+ * When debugging is enabled:
+ * - The markup of each Twig template is surrounded by HTML comments with
+ *   information such as template file name suggestions.
+ * - The 'dump' function can be used in Twig templates to output information
+ *   about template variables.
+ * - Twig templates are automatically recompiled whenever the source code
+ *   changes (see twig_auto_reload below).
+ *
+ * For more information about debugging Twig templates, see
+ * http://drupal.org/node/1906392.
  *
  * Not recommended in production environments (Default: FALSE).
  */