fix #208, extend documentation (#228)

c0fec0de · Oct 10, 2023 · de96295 · de96295
1 parent 94c4b75
commit de96295
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/docs/tricks/readonly.rst b/docs/tricks/readonly.rst
@@ -69,6 +69,13 @@ a
 │   └── a1a
 └── a2
 
+.. note::
+
+    It is important to use the ``_pre_*`` and **not** the ``_post_*`` methods.
+    An exception raised by `_pre_detach(parent)` and `_pre_attach(parent)` will **prevent** the tree structure to be updated.
+    The node keeps the old state.
+    An exception raised by `_post_detach(parent)` and `_post_attach(parent)` does **not rollback** the tree structure modification.
+
 
 Temporary
 ---------