Document the reworking of basket additions

docs/source/releases/v0.8.rst

@@ -17,6 +17,10 @@ Overview
 
 Oscar now has a demo site customised for the US!
 
+Things that have been heavily rewritten:
+
+- Adding product to the basket
+
 Lots of methods deprecated in the 0.6 release have now been removed.
 Specifically, the partner "wrapper" functionality is now gone. All price and
 availability logic now needs to be handled with strategies.
@@ -60,6 +64,17 @@ known.
 
 See :ref:`us_site` for more information.
 
+Basket additions clean-up
+-------------------------
+
+The forms and views around adding things to your basket has been vigorously
+reworked. This cleans up some very old code there and ensures variant products
+are handled in a consistent way.
+
+The changes do require changing the constructor signature of the
+``AddToBasketForm`` - the details are documented in the
+:ref:`basket_app_changes`.
+
 Cleanup around shipping methods
 -------------------------------
 
@@ -101,9 +116,6 @@ Minor changes
   forgotten when adding tracking of the Python and Django version in 0.7.
   Total information collected now is the versions of Django, Python and Oscar.
 
-Bugfixes
-~~~~~~~~
-
 .. _incompatible_changes_in_0.8:
 
 Backwards incompatible changes in 0.8
@@ -145,10 +157,26 @@ are no nulls in your ``basket_line`` table:
         else:
             line.delete()
 
-.. _removal_of_deprecated_features:
+.. _basket_app_changes:
+
+Basket app changes
+------------------
+
+- The ``basket:add`` URL now required the primary key of the "base" product to
+  be included. This allows the same form to be used for both GET and POST
+  requests for variant products.
+
+- The ``ProductSelectionForm`` is no longer used and has been removed.
+
+- The constructor of the :class:`~oscar.apps.basket.forms.AddToBasketForm` has
+  been adjusted to take the basket and the purchase info tuple as parameters
+  instead of the request instance (c74f57bf_ and 8ba283e8_).
+
+.. _c74f57bf: https://github.com/tangentlabs/django-oscar/commit/c74f57bf434661877f4d2d2259e7e7eb18b34951#diff-d200ac8746274e0307f512af886e1f3eR148
+.. _8ba283e8: https://github.com/tangentlabs/django-oscar/commit/8ba283e8c4239e4eff95da5e8097a17ecfadf5f5
 
 Migrations
-~~~~~~~~~~
+----------
 
 * Shipping: