diff --git a/docs/changelog/7.x.x.txt b/docs/changelog/7.x.x.txt
index 51b7db24a..68b9efd43 100644
--- a/docs/changelog/7.x.x.txt
+++ b/docs/changelog/7.x.x.txt
@@ -6,6 +6,7 @@
  - fixed #11777: Thingy search on yes no field fails
  - fixed #11787: Gallery resolutions wrongly ordered
  - fixed #11785: Article title / URL with äÄöÖüÜ (reopen #11683)
+ - fixed #11799: 7.8.24->7.9.11 upgrade breaks on custom Paydrivers
 
 7.9.12
  - webgui.org homepage gives 404  (#11778)
diff --git a/docs/gotcha.txt b/docs/gotcha.txt
index 8cffc0eee..5450d3231 100644
--- a/docs/gotcha.txt
+++ b/docs/gotcha.txt
@@ -63,6 +63,13 @@ save you many hours of grief.
      * The Cart will now work without javascript.  Javascript is used to make parts of the cart easier,
      and to automatically update the user's cart so they don't have to manually update it.
 
+     * All custom Payment drivers have to be rewritten.  Please read the POD for
+     WebGUI::Shop::PayDriver for information about the update.  The upgrade script for 7.9.4
+     is designed to die if a non-core payment driver is detected, so after updating your custom
+     driver you will need to change the upgrade script.
+
+     * Custom cart templates will need to be updated to accomodate the new cart design.
+
 7.9.3
 --------------------------------------------------------------------
      * Test:Deep, which had been an optional dependency for testing, has been used
diff --git a/lib/WebGUI/Shop/PayDriver.pm b/lib/WebGUI/Shop/PayDriver.pm
index e33ee7d0d..337127354 100644
--- a/lib/WebGUI/Shop/PayDriver.pm
+++ b/lib/WebGUI/Shop/PayDriver.pm
@@ -783,5 +783,20 @@ sub www_editSave {
     return undef;
 }
 
+=head2 CHANGES ( )
+
+=head3 7.9.4
+
+In 7.9.4, the base PayDriver class was changed to accomodate the new Cart.  The Cart is now in
+charge of gathering billing information.  The PayDriver's job is to summarize all the payment
+information for the user to review (www_getCredentials) and provide the user a button to complete
+the checkout process (getButton), and then to complete the checkout.  PayDrivers can
+do additional things beyond those steps, like the PayPal driver.
+
+PayDrivers also now have a defult template for displaying that screen, the summaryTemplate.
+While each core driver has its own template, custom drivers can use any existing one that
+meets its needs.
+
+=cut
 
 1;