change misleading variable name
typo in comment
more documentation