update the beta notes

technoweenie · technoweenie · commit 2d9b991782d8 · 2011-04-28T15:54:35.000-04:00
diff --git a/content/index.md b/content/index.md
@@ -15,4 +15,13 @@ Visit [GitHub API
 Support](http://support.github.com/discussions/api) if you
 have any problems or requests.
 
-**Note:** This API is in a beta state.  Breaking changes may occur.
+## Breaking BETA Changes
+
+We're making some small tweaks to the API during the BETA phase.  Old
+behavior is still supported, but due to be removed by June 1.  Please be
+sure to update your app in time.
+
+* Update requests used to accept the PUT verb.  Now POST or PATCH should
+  be used.
+* All URLs had a `.json` extension.  They don't anymore (but old
+  requests work still).
