Documentation review

after realizing that some documentation needed work for Iterator. we changed a bunch of unrelated stuff.