DOC: clarify preferred argument type
DOC/CLN: add missing newline to docstring