update description
add docblocks