Added documentation for the pagination support

Author: verschoof

doc/index.md

@@ -16,10 +16,9 @@ APIs:
 * [Repositories](repos.md)
 * [Users](users.md)
 
-* [Result Pager](result_pager.md)
-
 Additional features:
 
+* [Pagination support](result_pager.md)
 * [Authentication & Security](security.md)
 * [Request any Route](request_any_route.md)
 * [Customize `php-github-api` and testing](customize.md)

doc/result_pager.md

@@ -3,13 +3,42 @@
 
 ### Usage examples
 
-Get all results of a organization
+Get all repositories of a organization
 
 ```php
 $client = new Github\Client();
 
 $organizationApi = $client->api('organization');
 
 $paginator = new Github\ResultPager( $client );
-$result    = $paginator->fetchAll( $organizationApi, 'repositories', 'future500' );
+$result    = $paginator->fetchAll( $organizationApi, 'repositories', 'github );
 ```
+
+Get the first page
+```php
+$client = new Github\Client();
+
+$organizationApi = $client->api('organization');
+
+$paginator = new Github\ResultPager( $client );
+$result    = $paginator->fetch( $organizationApi, 'repositories', 'github );
+```
+Check for a next page:
+```php
+$paginator->hasNext();
+```
+
+Get next page:
+```php
+$paginator->fetchNext();
+```
+
+Check for pervious page:
+```php
+$paginator->getPrevious();
+```
+
+Get prevrious page:
+```php
+$paginator->fetchPrevious();
+```