added docstrigns for new functions