Descriptive docstring = great!  [PEP257](http://legacy.python.org/dev/peps/pep-0257/#multi-line-docstrings) suggests a one-line summary at the beginning, and then a full explanation.