diff --git a/core/themes/engines/twig/twig.engine b/core/themes/engines/twig/twig.engine
index be7ed16..d98f021 100644
--- a/core/themes/engines/twig/twig.engine
+++ b/core/themes/engines/twig/twig.engine
@@ -31,7 +31,7 @@ function twig_init($template) {
 }
 
 /**
- * Renders twig templates.
+ * Renders a Twig template.
  *
  * This retrieves Twig_Environment from the container and renders the template.
  *
@@ -44,7 +44,7 @@ function twig_init($template) {
  *   A keyed array of variables that will appear in the output.
  *
  * @return
- *   The output generated by the template, in addition to any debug information.
+ *   The output generated by the template, plus any debug information.
  */
 function twig_render_template($template_file, $variables) {
   $variables['_references'] = array();
diff --git a/sites/default/default.settings.php b/sites/default/default.settings.php
index 909a2c8..095852a 100755
--- a/sites/default/default.settings.php
+++ b/sites/default/default.settings.php
@@ -288,7 +288,7 @@
  *
  * Displays debugging information in comments surrounding Twig template output.
  *
- * Not recommended in production environments.
+ * Not recommended in production environments (Default: FALSE).
  */
 # $settings['twig_debug'] = TRUE;
 
@@ -297,17 +297,19 @@
  *
  * Automatically reload Twig templates whenever the source code changes.
  *
- * Not recommended in production environments.
+ * Not recommended in production environments (Default: FALSE).
  */
 # $settings['twig_auto_reload'] = TRUE;
 
 /**
  * Twig cache:
  *
- * Disabling the Twig cache will store the compiled Twig templates in RAM
- * instead of the file system.
+ * By default, Twig templates will be compiled and stored in the filesystem to
+ * increase performance. Disabling the Twig cache will recompile the templates
+ * from source each time they are used. In most cases the twig_auto_reload
+ * setting above should be enabled rather than disabling the Twig cache.
  *
- * Not recommended in production environments.
+ * Not recommended in production environments (Default: TRUE).
  */
 # $settings['twig_cache'] = FALSE;