diff --git a/config/settings.yml b/config/settings.yml
index e6d732b..d8c4710 100644
--- a/config/settings.yml
+++ b/config/settings.yml
@@ -1,8 +1,16 @@
 # Values formatted like "_env:ENV_VAR_NAME:default_value" can be overridden by
 # the specified environment variable. See the Yesod wiki, Configuration page.
 
+###############################################################################
+# Static files
+###############################################################################
+
 static-dir:     "_env:STATIC_DIR:static"
 
+###############################################################################
+# HTTP server
+###############################################################################
+
 # any IPv4 host
 host:           "_env:HOST:*4"
 
@@ -16,6 +24,10 @@ ip-from-header: "_env:IP_FROM_HEADER:false"
 # Uncomment to set an explicit approot
 #approot:        "_env:APPROOT:http://localhost:3000"
 
+###############################################################################
+# Development
+###############################################################################
+
 # Optional values with the following production defaults.
 # In development, they default to the inverse.
 #
@@ -26,6 +38,10 @@ ip-from-header: "_env:IP_FROM_HEADER:false"
 # mutable-static: false
 # skip-combining: false
 
+###############################################################################
+# SQL database
+###############################################################################
+
 # 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 the Yesod wiki, Configuration
 # page.
@@ -38,8 +54,37 @@ database:
   database: "_env:PGDATABASE:vervis_dev"
   poolsize: "_env:PGPOOLSIZE:10"
 
+###############################################################################
+# Version control repositories
+###############################################################################
+
 repo-dir:     repos
+
+###############################################################################
+# SSH server
+###############################################################################
+
 ssh-port:     5022
 ssh-key-file: config/ssh-host-key
+
+###############################################################################
+# Accounts
+###############################################################################
+
 registration: false
 max-accounts: 3
+
+###############################################################################
+# Mail
+###############################################################################
+
+# Optional SMTP server settings for sending email. If not provided, no email
+# will be sent. The login field is optional, provide if you need SMTP
+# authentication.
+
+# smtp:
+#   login:
+#     user:       "_env:SMTPUSER:vervis_dev"
+#     password:   "_env:SMTPPASS:vervis_dev_password"
+#   host:       "_env:SMTPHOST:localhost"
+#   port:       "_env:SMTPPORT:587"