improve doc related with recent change

Author: bagerard

docs/changelog.rst

@@ -12,6 +12,7 @@ Development
 - Fix deepcopy of EmbeddedDocument #2202
 - Fix error when using precision=0 with DecimalField #2535
 - Add support for regex and whole word text search query #2568
+- Add support for update aggregation pipeline #2578
 
 Changes in 0.23.1
 ===========

docs/guide/querying.rst

@@ -218,36 +218,35 @@ However, this doesn't map well to the syntax so you can also use a capital S ins
 
 Raw queries
 -----------
-It is possible to provide a raw :mod:`PyMongo` query as a query parameter or update as a update parameter , which will
-be integrated directly into the query or update. This is done using the ``__raw__``
-keyword argument::
+It is possible to provide a raw :mod:`PyMongo` query as a query parameter, which will
+be integrated directly into the query. This is done using the ``__raw__`` keyword argument::
 
     Page.objects(__raw__={'tags': 'coding'})
 
-    # or for update
-
-    Page.objects(__raw__={'tags': 'coding'}).update(__raw__={'$set': {'tags': 'coding'}})
+Similarly, a raw update can be provided to the :meth:`~mongoengine.queryset.QuerySet.update` method::
 
     Page.objects(tags='coding').update(__raw__={'$set': {'tags': 'coding'}})
 
-.. versionadded:: 0.4
+And the two can also be combined::
+
+    Page.objects(__raw__={'tags': 'coding'}).update(__raw__={'$set': {'tags': 'coding'}})
 
 
 Update with Aggregation Pipeline
------------
+--------------------------------
 It is possible to provide a raw :mod:`PyMongo` aggregation update parameter, which will
-be integrated directly into the update. This is done by using ``__raw__`` field and value of array
-pipeline
+be integrated directly into the update. This is done by using ``__raw__`` keyword argument to the update method
+and provide the pipeline as a list
 `Update with Aggregation Pipeline <https://docs.mongodb.com/manual/reference/method/db.collection.updateMany/#update-with-aggregation->`_
-keyword argument::
+::
 
     # 'tags' field is set to 'coding is fun'
     Page.objects(tags='coding').update(__raw__=[
         {"$set": {"tags": {"$concat": ["$tags", "is fun"]}}}
         ],
     )
 
-.. versionadded:: 0.4
+.. versionadded:: 0.23.2
 
 Sorting/Ordering results
 ========================