update docblocks and fixed typo