updated docblocks and readme file