Document more clearly that the insert order is an implementation deta…

…il (#10883)
doctrine · Aug 9, 2023 · 16c0151 · 16c0151
1 parent 440b244
commit 16c0151
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/en/reference/working-with-objects.rst b/docs/en/reference/working-with-objects.rst
@@ -192,6 +192,11 @@ be properly synchronized with the database when
     database in the most efficient way and a single, short transaction,
     taking care of maintaining referential integrity.
 
+.. note::
+
+    Do not make any assumptions in your code about the number of queries
+    it takes to flush changes, about the ordering of ``INSERT``, ``UPDATE``
+    and ``DELETE`` queries or the order in which entities will be processed.
 
 Example: