added explanation to the docstring