added docstrings
notebook update