add some docstrings and useful comments