adds detail to documentation for allowed and default parameter values