reduce arguments by passing options object along + tweak docs