Best way to document (phpdoc) generators (methods that yield)
When a generator function is called for the first time, an object of the internal Generator class is returned.
So strictly speaking, @return Generator would be correct, although not super descriptive of what you can expect to get back when you iterate over the generator.