diff --git a/docs/all.md b/docs/all.md
index eb9091f..5946bdf 100644
--- a/docs/all.md
+++ b/docs/all.md
@@ -5,8 +5,8 @@ These variables are required by multiple roles. Example values included.
 timezone: 'Europe/Helsinki'
 admin_email: 'admin@domain.tld'
 
-smtp_server: smtp.domain.tld
-smtp_from: sender@domain.tld
+smtp_server: smtp.domain.tld # Smtp server, must be reachable on port 587 with tls
+smtp_from: sender@domain.tld # Address to send mail from
 ```
 
 # Optional variables
@@ -15,7 +15,7 @@ These variables are used by multiple roles and have the following default values
 ```
 reverse_proxy_type: caddy # Allowed values: caddy, traefik, none
 
-smtp_from: # not defined, no smtp login by default
+smtp_user: # not defined, no smtp login by default
 smtp_pw: # not defined, see above
 
 ```