adding some notes to the docstring #163