diff --git a/README.in b/README.in
index ca4b8d6f0..332f8227a 100644
--- a/README.in
+++ b/README.in
@@ -289,6 +289,17 @@ features).
 Release Notes for Clutter 1.10
 -------------------------------------------------------------------------------
 
+• ClutterBox and ClutterGroup have been deprecated. ClutterActor should be
+  used directly, instead.
+
+• ClutterContainer provides default implementations for add(), remove(),
+  and foreach(); this means that overriding these methods is now deprecated,
+  and that developers should only implement ClutterContainer for classes
+  providing child properties.
+
+• ClutterActor is not an abstract type any more, and can be instantiated
+  either through clutter_actor_new() or through g_object_new().
+
 • ClutterActor now implements ClutterContainer, and takes over the entire API
   for modifying the scene graph; this means that every actor can have children
   and it's not necessary any more to implement the ClutterContainer interface.