minor update

- docblocks
- minor improvements