dem commentz
better comments
docstrings fix