issue #2 use docstrings