added notes to docstrings