Ticket #19415: 19415Docs.diff

docs/topics/db/aggregation.txt

@@ -323 +323 @@
 
     >>> Book.objects.filter(name__startswith="Django").aggregate(Avg('price'))
 
+When filtering against :ref:`multiple values <spanning-multi-valued-relationships>`,
+be careful to structure your filters according to the behavior you desire::
+
+    # Annotated list of all books with a title starting with "Django" *and* more than 100 pages.
+    >>> Book.objects.filter(name__startswith="Django",
+                    pages__gt=100).annotate(num_authors=Count('authors'))
+    # Annotated list of all books with a title starting with "Django" *as well as* all books with more than 100 pages.
+    >>>Book.objects.filter(name__startswith="Django").filter(
+                    pages__gt=100).annotate(num_authors=Count('authors'))
+
 Filtering on annotations
 ~~~~~~~~~~~~~~~~~~~~~~~~