add docs on iterators