V2 pagination with getValue unclear

The documentation Get a collection of items mentions paging, but the example and code are not entirely clear here.

The call $messages->getValue() from the example would return a native php array type.

Is that array already filled with all items from all pages? Is that guaranteed? Or do I only get a single page here?

On a side note, it might have been better to return a \Generator that can be iterated over, independent on the page size, that will simply call the next page when it's its turn.

Inizia dalla sezione sulla paginazione in docs/Examples.md, in particolare dall’esempio «Get a collection of items» e dalla relativa chiamata a $messages->getValue(). Traccia il comportamento di paginazione pertinente nell’SDK, quindi documenta se getValue() contiene una pagina o tutte le pagine e chiarisci l’esempio; l’idea richiesta di Generator è una considerazione separata.