#178: Documentation added for Github\Client\Search

Author: Yevgen Kovalienia

doc/search.md

@@ -0,0 +1,48 @@
+## Search API
+[Back to the navigation](index.md)
+
+Searching repositories, code, issues and users.
+Wrap [GitHub Search API](http://developer.github.com/v3/search/). All methods are described on that page.
+
+### Search repositories
+
+```php
+$repos = $client->api('search')->repositories('github language:php');
+```
+
+Returns a list of repositories found by such criteria.
+
+### Search code
+ 
+```php
+$repos = $client->api('search')->code('@todo language:php');
+```
+
+Returns a list of files found by such criteria (containing "@todo" and language==php).
+
+### Search issues
+
+```php
+$repos = $client->api('search')->issues('bug language:php');
+```
+
+Returns a list of issues found by such criteria.
+
+### Search users
+
+```php
+$repos = $client->api('search')->users('location:Amsterdam language:php');
+```
+
+Returns a list of users found by such criteria.
+
+### Sorting results
+
+You can sort results using 2-3 arguments.
+
+```php
+$repos = $client->api('repo')->repositories('...', 'created', 'asc');
+$repos = $client->api('repo')->code('...........', 'indexed', 'desc');
+$repos = $client->api('repo')->issues('.........', 'comments', 'asc');
+$repos = $client->api('repo')->users('..........', 'followers', 'asc');
+```