Add milestones doc, closes #142

Author: cursedcoder

doc/issue/milestones.md

@@ -0,0 +1,40 @@
+## Issues / Milestones API
+[Back to the "Issues API"](../issues.md) | [Back to the navigation](../README.md)
+
+Wraps [GitHub Issue Milestones API](http://developer.github.com/v3/issues/milestones/).
+
+### List project milestones
+
+```php
+$milestones = $client->api('issue')->milestones()->all('KnpLabs', 'php-github-api');
+```
+
+### Get information about milestone
+
+```php
+$milestone = $client->api('issue')->milestones()->show('KnpLabs', 'php-github-api', 123);
+```
+
+### Create a new milestone
+
+```php
+$milestone = $client->api('issue')->milestones()->create('KnpLabs', 'php-github-api', array('title' => '3.0'));
+```
+
+### Update a milestone
+
+```php
+$milestone = $client->api('issue')->milestones()->update('KnpLabs', 'php-github-api', 123);
+```
+
+### Remove a milestonre
+
+```php
+$client->api('issue')->milestones()->remove('KnpLabs', 'php-github-api', 123);
+```
+
+### List milestone labels
+
+```php
+$labels = $client->api('issue')->milestones()->labels('KnpLabs', 'php-github-api', 123);
+```

doc/issues.md

@@ -7,6 +7,7 @@ Wraps [GitHub Issue API](http://developer.github.com/v3/issues/).
 Additional APIs:
 * [Comments](issue/comments.md)
 * [Labels](issue/labels.md)
+* [Milestones](issue/milestones.md)
 
 ### List issues in a project
 

lib/Github/Api/Issue/Milestones.php

@@ -43,22 +43,22 @@ public function create($username, $repository, array $params)
         return $this->post('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones', $params);
     }
 
-    public function update($username, $repository, $milestone, array $params)
+    public function update($username, $repository, $id, array $params)
     {
         if (isset($params['state']) && !in_array($params['state'], array('open', 'closed'))) {
             $params['state'] = 'open';
         }
 
-        return $this->patch('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($milestone), $params);
+        return $this->patch('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($id), $params);
     }
 
-    public function remove($username, $repository, $milestone)
+    public function remove($username, $repository, $id)
     {
-        return $this->delete('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($milestone));
+        return $this->delete('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($id));
     }
 
-    public function labels($username, $repository, $milestone)
+    public function labels($username, $repository, $id)
     {
-        return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($milestone).'/labels');
+        return $this->get('repos/'.rawurlencode($username).'/'.rawurlencode($repository).'/milestones/'.rawurlencode($id).'/labels');
     }
 }