diff --git a/addons/mail/doc/index.rst.inc b/addons/mail/doc/index.rst.inc
index 4679cd56fdf..822d855d5b4 100644
--- a/addons/mail/doc/index.rst.inc
+++ b/addons/mail/doc/index.rst.inc
@@ -9,3 +9,4 @@ Mail Module documentation topics
    mail_thread
    mail_openchatter_howto
    mail_needaction_howto
+   mail_partner
diff --git a/addons/mail/doc/mail_partner.rst b/addons/mail/doc/mail_partner.rst
new file mode 100644
index 00000000000..baf025b8d8d
--- /dev/null
+++ b/addons/mail/doc/mail_partner.rst
@@ -0,0 +1,9 @@
+what is shown
+==============
+ - for every opportunities, sale orders and invoices which are related to partner show in the partner view
+
+
+how it is done
+===============
+ - _inherit = 'mail.thread'
+ - Override def message_load_ids method based on search by the partner_id and res_id