improve docblock with possible values and default