less crunchy parameter name
more concise maybe?
required is more clear
added scaladoc