From fb54361eadf5edd7c736784ac3427d73877895a5 Mon Sep 17 00:00:00 2001 From: Ryan P Kilby Date: Mon, 27 Jan 2020 16:41:20 -0800 Subject: [PATCH] Point Meta.together deprecation to Meta.groups --- docs/guide/migration.txt | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/guide/migration.txt b/docs/guide/migration.txt index c09e6ac3f..9ec6ac852 100644 --- a/docs/guide/migration.txt +++ b/docs/guide/migration.txt @@ -72,9 +72,19 @@ FilterSet ``Meta.together`` option removed (`#791`__) ----------------------------------------------------- __ https://github.com/carltongibson/django-filter/pull/791 -The ``Meta.together`` has been deprecated in favor of userland implementations -that override the ``clean`` method of the ``Meta.form`` class. An example will -be provided in a "recipes" section in future docs. +The ``Meta.together`` has been deprecated, and has now been replaced by the +``Meta.groups`` option, which provides a more generic and flexible interface. +For more information, see the :doc:`group reference `. + +.. code-block:: python + + class ProductFilter(django_filters.FilterSet): + class Meta: + model = Product + fields = ['price', 'release_date', 'rating'] + groups = [ + RequiredGroup(['rating', 'price']), + ] FilterSet "strictness" handling moved to view (`#788`__)