The Pairs example (playground link) in the iter package doc seems incorrect, with it looping forever while emitting the same values.

Another minor issue is it has an extra bool in the returned func signature. (Probably an older signature).

If we correct the extra bool, we can see it timeout on the playground:

// Pairs returns an iterator over successive pairs of values from seq.
func Pairs[V any](seq iter.Seq[V]) iter.Seq2[V, V] {
	return func(yield func(V, V) bool) {
		next, stop := iter.Pull(seq)
		defer stop()
		v1, ok1 := next()
		v2, ok2 := next()
		for ok1 || ok2 {
			if !yield(v1, v2) {
				return
			}
		}
	}
}

One possible correction might be this.

Unless someone beats me to it (which would be fine 😅), I will probably send a CL, but opening this issue in case any discussion is needed, including maybe I misunderstood the intent.

Finally, at first was unsure if it was meant to show overlapping vs. non-overlapping pairs. (I think the intent was probably non-overlapping pairs. I think itertools.pairwise in Python and std::ranges::views::pairwise_transform in C++ on the other hand both give overlapping pairs. That's probably fine, including this is just intended to be a simple example of using iter.Pull).