documented iterators and writers