adding documentation for variable substitution