sorry, to be more explicit: please update the docstrings to match the function signatures