[MERGE] forward port branch 12.0 up to b3052b690fa

1 files changed, 9 insertions, 8 deletions

diff --git a/doc/reference/orm.rst b/doc/reference/orm.rst
index 05254797ee8..f0c0452c8d5 100644
--- a/doc/reference/orm.rst
+++ b/doc/reference/orm.rst
@@ -700,9 +700,10 @@ Model Reference
 
     .. attribute:: _parent_store
 
-        Alongside :attr:`~.parent_left` and :attr:`~.parent_right`, sets up a
-        `nested set <http://en.wikipedia.org/wiki/Nested_set_model>`_  to
-        enable fast hierarchical queries on the records of the current model
+        Alongside a :attr:`~.parent_path` field, sets up an indexed storage
+        of the tree structure of records, to enable faster hierarchical queries
+        on the records of the current model using the ``child_of`` and
+        ``parent_of`` domain operators.
         (default: ``False``)
 
         :type: bool
@@ -825,17 +826,17 @@ Model Reference
     .. attribute:: parent_id
 
         used to order records in a tree structure and enables the ``child_of``
-        operator in domains
+        and ``parent_of`` operators in domains
 
         :type: :class:`~odoo.fields.Many2one`
 
-    .. attribute:: parent_left
+    .. attribute:: parent_path
 
-        used with :attr:`~._parent_store`, allows faster tree structure access
+        used to store an index of the tree structure when :attr:`~._parent_store`
+        is set to True - must be declared with ``index=True`` for proper operation.
 
-    .. attribute:: parent_right
+        :type: :class:`~odoo.fields.Char`
 
-        see :attr:`~.parent_left`
 
 .. _reference/orm/decorators: