updated iteration docblocks