From 2958013fa3ff25d3c95a1cafff3c4fd86b1d23e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Voet=20=28ryv=29?= <ryv@odoo.com>
Date: Tue, 12 Nov 2024 11:37:28 +0100
Subject: [PATCH] [IMP] orm: Deprecated read_group
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update documentation for the deprecatation of read_group.

closes odoo/documentation#11354

Related: odoo/odoo#163300
Related: odoo/enterprise#62388
Related: odoo/upgrade#6682
Signed-off-by: Rémy Voet (ryv) <ryv@odoo.com>
---
 content/developer/reference/backend/orm.rst                 | 2 --
 content/developer/reference/backend/orm/changelog.rst       | 6 ++++++
 .../reference/user_interface/view_architectures.rst         | 6 ++----
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/content/developer/reference/backend/orm.rst b/content/developer/reference/backend/orm.rst
index ce995d81a..1a79c3ec5 100644
--- a/content/developer/reference/backend/orm.rst
+++ b/content/developer/reference/backend/orm.rst
@@ -889,8 +889,6 @@ Search/Read
 
 .. automethod:: Model._read_group
 
-.. automethod:: Model.read_group
-
 Fields
 ~~~~~~
 
diff --git a/content/developer/reference/backend/orm/changelog.rst b/content/developer/reference/backend/orm/changelog.rst
index d6deeeed8..bb4060401 100644
--- a/content/developer/reference/backend/orm/changelog.rst
+++ b/content/developer/reference/backend/orm/changelog.rst
@@ -4,6 +4,12 @@
 Changelog
 =========
 
+Odoo Online version 18.2
+========================
+
+- `read_group` has been deprecated in favor of `_read_group` for backend usage and of
+  `formatted_read_group` as formatted public API. See `#163300 <https://github.com/odoo/odoo/pull/163300>`_.
+
 Odoo Online version 18.1
 ========================
 
diff --git a/content/developer/reference/user_interface/view_architectures.rst b/content/developer/reference/user_interface/view_architectures.rst
index 2faceffb9..ce45d5dd3 100644
--- a/content/developer/reference/user_interface/view_architectures.rst
+++ b/content/developer/reference/user_interface/view_architectures.rst
@@ -2084,9 +2084,7 @@ The `filter` element can have the following attributes:
    the :guilabel:`Group By` menu. When the field is of type `date` or `datetime`, the filter
    generates a submenu of the :guilabel:`Group By` menu with the following interval options
    available: :guilabel:`Year`, :guilabel:`Quarter`, :guilabel:`Month`, :guilabel:`Week`, and
-   :guilabel:`Day`. When the filter is in the default set of filters activated at the view
-   initialization, the records are grouped by month by default. This can be changed by using the
-   syntax `date_field:interval`.
+   :guilabel:`Day`.
 
    .. example::
       .. code-block:: xml
@@ -2095,7 +2093,7 @@ The `filter` element can have the following attributes:
          <filter string="Creation Date" name="groupby_create_date" context="{'group_by': 'create_date:week'}"/>
 
    .. note::
-      The results of `read_groups` grouped on a field may be influenced by its `group_expand`
+      The results of `formatted_read_group` grouped on a field may be influenced by its `group_expand`
       attribute, allowing to display empty groups when needed. For more information, please refer to
       :class:`~odoo.fields.Field`.