act like the change blog is a thing now

technoweenie · technoweenie · commit 6c81655197bb · 2012-09-06T14:22:56.000-06:00
diff --git a/content/changes/2012-9-5-watcher-api.html b/content/changes/2012-9-5-watcher-api.html
@@ -25,7 +25,7 @@
 * `/users/:user/watched` - A list of repositories that a user has starred.
 * `/user/watched` - A list of repositories the current user has starred.
 
-[starring-api]: http://developer.github.com/v3/repos/watching/
+[starring-api]: http://developer.github.com/v3/repos/starring/
 
 ## Phase 1: Add Watchers as Subscriptions
 
@@ -43,20 +43,21 @@
 * `/users/:user/starred` - A list of repositories that a user has starred.
 * `/user/starred` - A list of repositories the current user has starred.
 
-This will be done with the current mime type for the API:
+This is in place _now_ with the current media type for the API:
 
     application/vnd.github.beta+json
 
 If you care about your application not breaking, make sure all outgoing API
-requests pass that value for the "Accept" header.  You should do this now, even
-before Phase 1 starts.
+requests pass that value for the "Accept" header.  You should do this now.  This
+can be verified by checking the `X-GitHub-Media-Type` header on all API
+responses.
 
     # Accesses a user's starred repositories.
     curl https://api.github.com/user/watched \
       -H "Accept: application/vnd.github.beta+json"
 
 This Phase will be broken once Phase 3 starts.  Phase 3 removes all support for
-the "beta" mime type, and makes the "v3" mime type the implicit default
+the "beta" media type, and makes the "v3" media type the implicit default
 for API requests.
 
 ## Phase 2: Switch `/watchers` API Endpoint
@@ -65,13 +66,13 @@
 will have to use `/user/starred` to get a user's starred repositories, not
 `/user/watched`.
 
-This requires a new mime type value:
+This requires a new media type value:
 
     application/vnd.github.v3+json
 
 This is a breaking change from Phase 1.  We will release this change in an
 experimental mode first, letting developers gracefully upgrade their
-applications by specifying the new mime value for the Accept header.
+applications by specifying the new media value for the Accept header.
 
     # Accesses a user's watched repositories.
     curl https://api.github.com/user/watched \
@@ -83,6 +84,6 @@
 point, you should be using the starring endpoints for starred repositories, and
 the watch endpoints for watched repositories.
 
-Keep on passing the "v3" mimetype in your application, until the API has
+Keep on passing the "v3" media type in your application, until the API has
 another breaking change to make.
 
diff --git a/content/v3/repos/starring.md b/content/v3/repos/starring.md
@@ -16,7 +16,9 @@ We recently [changed the way watching
 works](https://github.com/blog/1204-notifications-stars) on GitHub.  Many 3rd
 party applications may be using the "watcher" endpoints for accessing these.
 Starting today, you can start changing these to the new "star" endpoints.  See
-below.
+below.  Check the [Watcher API Change post](/changes/2012-9-5-watcher-api/) for
+more.
+
 
 ## List Stargazers
 
diff --git a/content/v3/repos/watching.md b/content/v3/repos/watching.md
@@ -14,7 +14,8 @@ Starring](/v3/repos/starring) for simple repository bookmarks.
 We recently [changed the way watching
 works](https://github.com/blog/1204-notifications-stars) on GitHub.  Until 3rd
 party applications stop using the "watcher" endpoints for the current Starring
-API, the Watching API will use the below "subscription" endpoints.
+API, the Watching API will use the below "subscription" endpoints.  Check the
+[Watcher API Change post](/changes/2012-9-5-watcher-api/) for more.
 
 ## List watchers
 
