In README.asciidoc we say
NOTE: Passwords used to secure various services. You are advised to specify
only alphanumeric values in this script as others may cause syntax
errors depending on context. If non-alphanumeric values are required,
update them separately after installation.
We should audit all situations where we deal with passwords and other strings which may contain special characters to ensure safety rather than suggesting users avoid special characters.