I don't mean to be crazy pedantic about this, but in docstrings, use good English form (caps, periods, etc); use a first line that summarizes the function; if you have only obvious things to say, state them, but you probably have non-obvious things to say.