diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index e8ce306112..2638c7d9dc 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -133,7 +133,7 @@
     <section>
       <title>Adapt to GtkWidget's size request changes</title>
       <para>
-        GTK+3 used five different virtual functions in GtkWidget to
+        GTK+ 3 used five different virtual functions in GtkWidget to
         implement size requisition, namely the gtk_widget_get_preferred_width()
         family of functions. To simplify widget implementations, GTK+4 uses
         only one virtual function, GtkWidgetClass::measure() that widgets
@@ -141,6 +141,14 @@
       </para>
     </section>
 
+    <section>
+      <title>Don't use -gtk-gradient in your CSS</title>
+      <para>
+        GTK+ now supports standard CSS syntax for both linear and radial
+        gradients, just use those.
+      </para>
+    </section>
+
   </section>
 
 </chapter>