diff --git a/readme-vars.yml b/readme-vars.yml
index 57fc1d5..5ba4232 100644
--- a/readme-vars.yml
+++ b/readme-vars.yml
@@ -29,7 +29,7 @@ param_env_vars:
   - { env_var: "DB_HOST", env_value: "<yourdbhost>", desc: "for specifying the database host" }
   - { env_var: "DB_USER", env_value: "<yourdbuser>", desc: "for specifying the database user" }
   - { env_var: "DB_PASS", env_value: "<yourdbpass>", desc: "for specifying the database password" }
-  - { env_var: "DB_DATABASE", env_value: "bookstackapp", desc: "for specifying the database to be used" }
+  - { env_var: "DB_DATABASE", env_value: "bookstackapp", desc: "for specifying the database to be used (non-alphanumeric passwords must be properly escaped.)" }
 
 param_usage_include_ports: true
 param_ports: