Merge pull request github#305 from github/clarify-watchevent

gjtorikian · gjtorikian · commit 9734fe09c100 · 2013-09-18T09:23:23.000-07:00
Clarify that WatchEvent is used for starring
diff --git a/content/v3/activity/events/types.md b/content/v3/activity/events/types.md
@@ -245,11 +245,14 @@ repo
 
 ## WatchEvent
 
-The event's actor is the watcher, and the event's repo is the watched
-repository.
+The WatchEvent is related to starring a repository, not watching.
+See [this API blog post](http://developer.github.com/changes/2012-9-5-watcher-api/)
+for an explanation.
+
+The event&rsquo;s actor is the user who starred a repository, and the event&rsquo;s repo is
+the repository that was starred.
 
 Hook name: `watch`
 
 action
-: **string** - The action that was performed.
-
+: **string** - The action that was performed: "started".
