could also document the return value format in the docstring