update docstring to better reflect current reality