updated docstrings of methods