diff --git a/content/index.md b/content/index.md
index 2b3b8b76c1..641a0932f1 100644
--- a/content/index.md
+++ b/content/index.md
@@ -48,6 +48,9 @@ The API is expected to be finalized Real Soon Now.
 
 ### Breaking Beta Changes
 
+##### August 7, 2012
+* Clarified watching/stargazing
+
 ##### June 12, 2012:
 * Removed API v1 support
 * Removed API v2 support
diff --git a/content/v3/repos/watching.md b/content/v3/repos/watching.md
index b7905ba89b..f2826b7970 100644
--- a/content/v3/repos/watching.md
+++ b/content/v3/repos/watching.md
@@ -4,6 +4,13 @@ title: Repo Watching | GitHub API
 
 # Repo Watching API
 
+We recently [changed the way watching
+works](https://github.com/blog/1204-notifications-stars) on GitHub. We hope to
+roll out many of these features in the API soon. Until then, the [Watchers
+method](#list-watchers) below will return "stargazers", and the [Watched
+methods](#list-repos-being-watched) return repositories that have been
+"starred."
+
 ## List watchers
 
     GET /repos/:user/:repo/watchers