- added more comments
- updated docs