remove unnecessary params code
add needed parens
add supporting documentation