diff --git a/config/settings.yml b/config/settings.yml
index 21630d7db..0f661c776 100644
--- a/config/settings.yml
+++ b/config/settings.yml
@@ -1,27 +1,28 @@
 # Values formatted like "_env:ENV_VAR_NAME:default_value" can be overridden by the specified environment variable.
 # See https://github.com/yesodweb/yesod/wiki/Configuration#overriding-configuration-values-with-environment-variables
+# NB: If you need a numeric value (e.g. 123) to parse as a String, wrap it in single quotes (e.g. "_env:PGPASS:'123'")
+# See https://github.com/yesodweb/yesod/wiki/Configuration#parsing-numeric-values-as-strings
 
 static-dir:     "_env:STATIC_DIR:static"
 host:           "_env:HOST:*4" # any IPv4 host
-port:           "_env:PORT:3000" # NB: The port `yesod devel` uses is distinct from this value. Set the `yesod devel` port from the command line.
+port:           "_env:PORT:3000"
 ip-from-header: "_env:IP_FROM_HEADER:false"
 
-# Default behavior: determine the application root from the request headers.
-# Uncomment to set an explicit approot
 approot:        "_env:APPROOT:http://localhost:3000"
 
 detailed-logging: "_env:DETAILED_LOGGING:false"
 should-log-all: "_env:LOG_ALL:false"
 minimum-log-level: "_env:LOGLEVEL:warn"
-# reload-templates: false
-# mutable-static: false
-# skip-combining: false
 auth-dummy-login: "_env:DUMMY_LOGIN:false"
 auth-pwfile: "_env:PWFILE:"
 allow-deprecated: "_env:ALLOW_DEPRECATED:false"
 
-# NB: If you need a numeric value (e.g. 123) to parse as a String, wrap it in single quotes (e.g. "_env:PGPASS:'123'")
-# See https://github.com/yesodweb/yesod/wiki/Configuration#parsing-numeric-values-as-strings
+# Optional values with the following production defaults.
+# In development, they default to true.
+# reload-templates: false
+# mutable-static: false
+# skip-combining: false
+
 
 database:
   user:     "_env:PGUSER:uniworx"