Clarify pagination API, add page_size

docs/index.rst

@@ -169,7 +169,7 @@ You can also specify filters
 
     tasks = api.tasks.list(project=1)
 
-By defaults list returns all objects, eventually getting the
+By default list returns all objects, eventually getting the
 paginated results behind the scenes.
 
 If you want to disable pagination support and get all the
@@ -190,6 +190,12 @@ argument and the page number
    tasks_page_1 = api.tasks.list(lazy_pagination)  # Will only return page 1
    tasks_page_2 = api.tasks.list(lazy_pagination, page=2)  # Will return page 2
 
+Page size (default: 100) can be passed as an argument
+
+   tasks_page_1 = api.tasks.list(lazy_pagination, page_size=200)  # Will return 200 results from page 2
+
+.. code:: python
+
 Attach a file
 ~~~~~~~~~~~~~