add some docs to docstring