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.

docs/Examples.md のページネーションのセクション、特に「Get a collection of items」の例とその $messages->getValue() 呼び出しから始めてください。SDK 内の関連するページネーション動作を追跡し、getValue() に含まれるのが 1 ページなのかすべてのページなのかを文書化して、例を明確にしてください。要求されている Generator のアイデアは別途検討するものです。