There is a pydoc standard for documenting arguments in docstrings. I guess it would be better to use it.