provide docblocks and fix method visibility