doc blocks and 2 tests