Add doc for Contents API

Author: Thibaud Fabre

doc/index.md

@@ -15,6 +15,7 @@ APIs:
 * [Pull Requests](pull_requests.md)
   * [Comments](pull_request/comments.md)
 * [Repositories](repos.md)
+  * [Contents](repo/contents.md)
   * [Releases](repo/releases.md)
     * [Assets](repo/assets.md)
 * [Users](users.md)

doc/repo/contents.md

@@ -0,0 +1,56 @@
+## Repo / Contents API
+[Back to the "Repos API"](../repos.md) | [Back to the navigation](../index.md)
+
+### Get a repository's README
+
+```php
+$readme = $client->api('repo')->contents()->readme('knp-labs', 'php-github-api', $reference);
+```
+
+### Get information about a repository file or directory
+
+```php
+$fileInfo = $client->api('repo')->contents()->show('knp-labs', 'php-github-api', $path, $reference);
+```
+
+### Check that a file or directory exists in the repository
+```php
+$fileExists = $client->api('repo')->contents()->exists('knp-labs', 'php-github-api', $path, $reference);
+```
+
+### Create a file
+```php
+$committer = array('name' => 'KnpLabs', 'email' => '[email protected]');
+
+$fileInfo = $client->api('repo')->contents()->create('knp-labs', 'php-github-api', $path, $content, $commitMessage, $branch, $committer);
+```
+
+### Update a file
+
+```php
+$committer = array('name' => 'KnpLabs', 'email' => '[email protected]');
+$oldFile = $client->api('repo')->contents()->show('knp-labs', 'php-github-api', $path, $branch);
+
+$fileInfo = $client->api('repo')->contents()->create('knp-labs', 'php-github-api', $path, $content, $commitMessage, $oldFile['sha'], $branch, $committer);
+```
+
+### Remove a file
+
+```php
+$committer = array('name' => 'KnpLabs', 'email' => '[email protected]');
+$oldFile = $client->api('repo')->contents()->show('knp-labs', 'php-github-api', $path, $branch);
+
+$fileInfo = $client->api('repo')->contents()->rm('knp-labs', 'php-github-api', $path, $commitMessage, $oldFile['sha'], $branch, $committer);
+```
+
+### Get repository archive
+
+```php
+// @todo Document
+```
+
+### Download a file
+
+```php
+$fileContent = $client->api('repo')->contents()->download('knp-labs', 'php-github-api', $path, $reference);
+```