Updated docs

Author: Nyholm

README.md

@@ -9,7 +9,7 @@ Uses [GitHub API v3](http://developer.github.com/v3/). The object API is very si
 
 ## Features
 
-* Follows PSR-0 conventions and coding standard: autoload friendly
+* Follows PSR-4 conventions and coding standard: autoload friendly
 * Light and fast thanks to lazy loading of API classes
 * Extensively tested and documented
 
@@ -33,7 +33,9 @@ Then run the following command to require the library:
 $ php composer.phar require knplabs/github-api php-http/guzzle6-adapter
 ```
 
-> `php-github-api` follows the PSR-0 convention names for its classes, which means you can easily integrate `php-github-api` classes loading in your own autoloader.
+> `php-github-api` follows the PSR-4 convention names for its classes, which means you can easily integrate `php-github-api` classes loading in your own autoloader.
+
+Why `php-http/guzzle6-adapter`? We are decoupled form any HTTP messaging client with help by [HTTPlug](http://httplug.io/). Read about clients in our [docs](doc/cusomize.md).
 
 ## Using Laravel?
 

doc/customize.md

@@ -1,9 +1,23 @@
 ## Customize `php-github-api` and testing
 [Back to the navigation](README.md)
 
-### Configure the http client
 
-Wanna change, let's say, the http client User Agent? You need to create a Plugin that modifies the
+### Inject a new HTTP client instance
+
+`php-github-api` relies on `php-http/discovery` to find an installed HTTP client. You may specify a HTTP client
+yourself by calling `\Github\Client::setHttpClient`. A HTTP client must implement `Http\Client\HttpClient`. A list of
+community provided clients is found here: https://packagist.org/providers/php-http/client-implementation
+
+You can inject a HTTP client through `Github\Client#setHttpClient()` method:
+
+```php
+$client = new Github\Client();
+$client->setHttpClient(new Http\Adapter\Guzzle6\Client());
+```
+
+### Configure the HTTP client
+
+Wanna change, let's say, the HTTP client User Agent? You need to create a Plugin that modifies the
 request. Read more about [HTTPlug plugins here](http://docs.php-http.org/en/latest/plugins/introduction.html#how-it-works).
 
 ```php
@@ -26,34 +40,6 @@ class CustomUserAgentPlugin implements Plugin
 $githubClient->addPlugin(new CustomUserAgentPlugin());
 ```
 
-### Inject a new http client instance
-
-`php-github-api` relies on `php-http/discovery` to find an installed http client. You may specify a HTTP client
-yourself by calling `\Github\Client::setHttpClient`. A HTTP client must implement `Http\Client\HttpClient`. A list of
-community provided clients is found here: https://packagist.org/providers/php-http/client-implementation
-
-```php
-use Github\HttpClient\HttpClient;
-
-// create a custom http client
-class MyHttpClient extends HttpClient
-{
-    public function request($url, array $parameters = array(), $httpMethod = 'GET', array $headers = array())
-    {
-        // send the request and return the raw response
-    }
-}
-```
-
-> Your http client implementation may not extend `Github\HttpClient\HttpClient`, but only implement `Github\HttpClient\HttpClientInterface`.
-
-You can now inject your http client through `Github\Client#setHttpClient()` method:
-
-```php
-$client = new Github\Client();
-$client->setHttpClient(new Http\Adapter\Guzzle6\Client());
-```
-
 ### Run Test Suite
 
 The code is unit tested, there are also some functional tests. To run tests on your machine, from a CLI, run