This is one of those "I hate to be picky" comments, but it'd be great if docstrings could start with a one-line description of the function, and then use a new paragraph for longer discussion.