diff --git a/docs/changelog/7.x.x.txt b/docs/changelog/7.x.x.txt
index 49bb87ca2..0011e30a9 100644
--- a/docs/changelog/7.x.x.txt
+++ b/docs/changelog/7.x.x.txt
@@ -6,6 +6,7 @@
  - fixed #12334: Company name with : in it breaks email sender identity
  - fixed #12328: invalid wgaccess file in uploads
  - RFE: 9730 (actually missing documentation)
+ - fixed: Crud updateFromFormPost
 
 7.10.24
  - fixed #12318: asset error causes asset manager to fail
diff --git a/docs/gotcha.txt b/docs/gotcha.txt
index 39cdfb4f8..93f2b1b18 100644
--- a/docs/gotcha.txt
+++ b/docs/gotcha.txt
@@ -7,6 +7,14 @@ upgrading from one version to the next, or even between multiple
 versions. Be sure to heed the warnings contained herein as they will
 save you many hours of grief.
 
+7.10.25
+--------------------------------------------------------------------
+    * Custom WebGUI plugins written using WebGUI::Crud with hand built forms
+      should be reviewed.  A serious bug in how Crud handles forms has been fixed,
+      and the side-effect of the bug is now that forms processed by updateFromFormPost
+      must include ALL fields, otherwise the data in fields which are missing from the
+      form will be lost.
+
 7.10.24
 --------------------------------------------------------------------
     * WebGUI now depends on Business::OnlinePayment::AuthorizeNet.  This version