Browse Source

Improved wording in Q() docs.

Adam Johnson 4 years ago
parent
commit
83c631ade7
1 changed files with 6 additions and 8 deletions
  1. 6 8
      docs/ref/models/querysets.txt

+ 6 - 8
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
 ----------------------