added lightweight mentions of iterators to help people avoid getting stuck when they see generator objects, cf #18