diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 87e29441ed..b697dfb2d9 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -670,7 +670,7 @@
       <title>Adapt to changes in GtkOverlay API</title>
       <para>
         The GtkOverlay::pass-through child property has been replaced by the
-        GtkWidget::can-pick property. Note that they have the oppositve sense:
+        GtkWidget::can-pick property. Note that they have the opposite sense:
         pass-through == !can-pick.
       </para>
     </section>
@@ -755,6 +755,14 @@
         instead.
       </para>
     </section>
+
+    <section>
+      <title>GtkPopover::modal has been renamed to autohide</title>
+      <para>
+        The modal property has been renamed to autohide.
+        gtk-builder-tool can assist with the rename in ui files.
+      </para>
+    </section>
   </section>
 
 </chapter>