updated the docblocks for all methods