fix: pagination example

Author: stainless-app[bot]

README.md

@@ -76,6 +76,69 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
+## Pagination
+
+List methods in the Gitpod API are paginated.
+
+This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
+
+```python
+from gitpod import Gitpod
+
+client = Gitpod()
+
+all_services = []
+# Automatically fetches more pages as needed.
+for service in client.environments.automations.services.list():
+    # Do something with service here
+    all_services.append(service)
+print(all_services)
+```
+
+Or, asynchronously:
+
+```python
+import asyncio
+from gitpod import AsyncGitpod
+
+client = AsyncGitpod()
+
+
+async def main() -> None:
+    all_services = []
+    # Iterate through items across all pages, issuing requests as needed.
+    async for service in client.environments.automations.services.list():
+        all_services.append(service)
+    print(all_services)
+
+
+asyncio.run(main())
+```
+
+Alternatively, you can use the `.has_next_page()`, `.next_page_info()`, or `.get_next_page()` methods for more granular control working with pages:
+
+```python
+first_page = await client.environments.automations.services.list()
+if first_page.has_next_page():
+    print(f"will fetch next page using these details: {first_page.next_page_info()}")
+    next_page = await first_page.get_next_page()
+    print(f"number of items we just fetched: {len(next_page.pagination.personal_access_tokens)}")
+
+# Remove `await` for non-async usage.
+```
+
+Or just work directly with the returned data:
+
+```python
+first_page = await client.environments.automations.services.list()
+
+print(f"next page cursor: {first_page.pagination.next_token}")  # => "next page cursor: ..."
+for service in first_page.pagination.personal_access_tokens:
+    print(service.pagination)
+
+# Remove `await` for non-async usage.
+```
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `gitpod.APIConnectionError` is raised.