Merge pull request MongoEngine#2610 from bagerard/improve_doc_upd_agg_pipeline

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
 - BREAKING CHANGE: Updates to support pymongo 4.0. Where possible deprecated
   functionality has been migrated, but additional care should be taken when
   migrating to pymongo 4.0 as existing code may have been using deprecated

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
 ========================