The function docstring should always be the first thing in the function.

Please read our style guide: https://github.com/UWFlow/rmc/wiki/Flow-Style-Guide

... which says that docstrings should follow http://legacy.python.org/dev/peps/pep-0257/