added docstrings to public methods