changed documentation and watch repo api endpoint

Author: valtlfelipe

doc/activity.md

@@ -1,10 +1,10 @@
 ## Activity API (incomplete)
 [Back to the navigation](index.md)
 
-Access to Starring and Watching a Repository for authenticated users.
+Access to Starring and Watching a Repository for [non] authenticated users.
 Wrap [GitHub Activity API](https://developer.github.com/v3/activity/).
 
-> No authentication required.
+> *** No authentication required. ***
 
 ### Get repos that a specific user has starred
 
@@ -14,7 +14,15 @@ $users = $client->api('user')->starred('ornicar');
 
 Returns an array of starred repos.
 
-> Requires [authentication](security.md).
+### Get repos that a specific user is watching
+
+```php
+$users = $client->api('user')->watched('ornicar');
+```
+
+Returns an array of watched repos.
+
+> *** Requires [authentication](security.md). ***
 
 ### Get repos that a authenticated user has starred
 
@@ -48,4 +56,39 @@ $owner = "KnpLabs";
 $repo = "php-github-api";
 $activity = $client->api('current_user')->starred()->unstar($owner, $repo);
 ```
+Throws an Exception in case of failure or NULL in case of success.
+
+
+### Get repos that a authenticated user is watching
+
+```php
+$activity = $client->api('current_user')->watchers()->all();
+```
+Returns an array of watched repos.
+
+### Check if authenticated user is watching a specific repo
+
+```php
+$owner = "KnpLabs";
+$repo = "php-github-api";
+$activity = $client->api('current_user')->watchers()->check($owner, $repo);
+```
+Throws an Exception with code 404 in case that the repo is not beeing watched by the authenticated user or NULL in case that it is beeing watched by the authenticated user.
+
+### Watch a specific repo for authenticated user
+
+```php
+$owner = "KnpLabs";
+$repo = "php-github-api";
+$activity = $client->api('current_user')->watchers()->watch($owner, $repo);
+```
+Throws an Exception in case of failure or NULL in case of success.
+
+### Stop watching a specific repo for authenticated user
+
+```php
+$owner = "KnpLabs";
+$repo = "php-github-api";
+$activity = $client->api('current_user')->watchers()->unwatch($owner, $repo);
+```
 Throws an Exception in case of failure or NULL in case of success.

lib/Github/Api/CurrentUser/Watchers.php

@@ -19,7 +19,7 @@ class Watchers extends AbstractApi
      */
     public function all($page = 1)
     {
-        return $this->get('user/watched', array(
+        return $this->get('user/subscriptions', array(
             'page' => $page
         ));
     }
@@ -34,7 +34,7 @@ public function all($page = 1)
      */
     public function check($username, $repository)
     {
-        return $this->get('user/watched/'.rawurlencode($username).'/'.rawurlencode($repository));
+        return $this->get('user/subscriptions/'.rawurlencode($username).'/'.rawurlencode($repository));
     }
 
     /**
@@ -47,7 +47,7 @@ public function check($username, $repository)
      */
     public function watch($username, $repository)
     {
-        return $this->put('user/watched/'.rawurlencode($username).'/'.rawurlencode($repository));
+        return $this->put('user/subscriptions/'.rawurlencode($username).'/'.rawurlencode($repository));
     }
 
     /**
@@ -60,6 +60,6 @@ public function watch($username, $repository)
      */
     public function unwatch($username, $repository)
     {
-        return $this->delete('user/watched/'.rawurlencode($username).'/'.rawurlencode($repository));
+        return $this->delete('user/subscriptions/'.rawurlencode($username).'/'.rawurlencode($repository));
     }
 }