Document iterator protocol better

r? @thestinger