add a bit more detail about the timeframes. /cc @sferik

technoweenie · technoweenie · commit 9296cc58cfaf · 2012-09-06T22:56:22.000-06:00
diff --git a/content/changes/2012-9-5-watcher-api.html b/content/changes/2012-9-5-watcher-api.html
@@ -82,8 +82,23 @@
 
 This phase involves disabling the subscription endpoints completely.  At this
 point, you should be using the starring endpoints for starred repositories, and
-the watch endpoints for watched repositories.
+the watch endpoints for watched repositories.  No date has been set yet, but we
+expect this to be _3-6 months_ after Phase 2 is in place.  This should give
+developers enough time to push changes out carefully.  If they use popular
+API wrappers, the work will likely mostly be done for them.
 
 Keep on passing the "v3" media type in your application, until the API has
-another breaking change to make.
+another breaking change to make.  If you can't make the deadline for Phase 3,
+just set the "beta" media type until we shut that down completely.  It's likely
+that we will keep the old "beta" media type active for another month, like
+the [last time](https://github.com/blog/1090-github-api-moving-on) we terminated
+old API functionality.
+
+We look forward to assisting you through this transition.  Hit us up at
+[https://github.com/contact][c], [support@github.com][email], or
+[@GitHubAPI][twitter].
+
+[twitter]: https://twitter.com/githubapi
+[email]: mailto:support@github.com
+[c]: https://github.com/c
 
