summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorAdam Johnson <me@adamj.eu>2020-05-06 05:43:28 +0100
committerGitHub <noreply@github.com>2020-05-06 06:43:28 +0200
commit83c631ade7b5f853580a44f3e8e8f6d6ea367b24 (patch)
treee1d493cb874fe9b4fa30788d02c52806eb68491c /docs/ref
parent1c2c6f1b51a540bddc7ae95f4d1213688411ca44 (diff)
Improved wording in Q() docs.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/models/querysets.txt14
1 files changed, 6 insertions, 8 deletions
diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
index cd22b03418..784d22ce4b 100644
--- a/docs/ref/models/querysets.txt
+++ b/docs/ref/models/querysets.txt
@@ -3567,14 +3567,12 @@ elsewhere.
.. class:: Q
-A ``Q()`` object, like an :class:`~django.db.models.F` object, encapsulates a
-SQL expression in a Python object that can be used in database-related
-operations.
-
-In general, ``Q() objects`` make it possible to define and reuse conditions.
-This permits the :ref:`construction of complex database queries
-<complex-lookups-with-q>` using ``|`` (``OR``) and ``&`` (``AND``) operators;
-in particular, it is not otherwise possible to use ``OR`` in ``QuerySets``.
+A ``Q()`` object represents an SQL condition that can be used in
+database-related operations. It's similar to how an
+:class:`F() <django.db.models.F>` object represents the value of a model field
+or annotation. They make it possible to define and reuse conditions, and
+combine them using operators such as ``|`` (``OR``) and ``&`` (``AND``). See
+:ref:`complex-lookups-with-q`.
``Prefetch()`` objects
----------------------