You should also give a short one-line summary of the function at the top of the docstring (which you'll see the other functions do).