remove abbreviated param names
add documentation to two params