improved comments
improved comments
more comment improvements
more comment improvements
first implementation, with docstrings and comments