Please document arguments. We've been using https://pypi.python.org/pypi/sphinxcontrib-napoleon for docstrings.