WIP: add brief comment on meaning of params