improving docblocks