Context Navigation

Changes between Version 3 and Version 4 of Ticket #36741, comment 2

-              v3
+              v4
+(Note: The screenshot you attached is from the bulk_update() section, not the update() section. "QuerySet.update()" is linked, and clicking it takes you to the update() section.)
+(Note: The screenshot you attached is from the bulk_update() section, not the update() section. "QuerySet.update()" is linked and directs to the update() section.)
+That said, I can see how the current wording could cause confusion - the bulk_update() documentation doesn't clarify that it uses update() internally.
+there is potential for confusion here since the bulk_update() documentation doesn't explain that update() is called internally. This might explain why the bulk_update() section could be mistaken for the update() section.
+I think the documentation could be improved with the following change:
+{{{
+diff --git a/docs/ref/models/querysets.txt b/docs/ref/models/querysets.txt
+--- a/docs/ref/models/querysets.txt
++++ b/docs/ref/models/querysets.txt
+@@ -2508,7 +2508,7 @@
+     >>> Entry.objects.bulk_update(objs, ["headline"])
+-:meth:`.QuerySet.update` is used to save the changes, so this is more efficient
++This method uses :meth:`.QuerySet.update` internally, making it more efficient
+ than iterating through the list of models and calling ``save()`` on each of
+ them, but it has a few caveats:
+}}}