refined docblocks