And this whole paragraph should be a comment in the code, not in the docstring.