more explicit docstrings