further clarify docstring