added a few comments in docstrings