Multi line docstrings should have a single summary line followed by a blank line, then the longer explanation of the function's intention.

http://legacy.python.org/dev/peps/pep-0257/#multi-line-docstrings