documented function.

python docstrings are to document return values. the attributes can be
accessed via introspection