diff --git a/partner_affiliate/README.rst b/partner_affiliate/README.rst
index 752a02121..36a9242b0 100644
--- a/partner_affiliate/README.rst
+++ b/partner_affiliate/README.rst
@@ -25,11 +25,15 @@ Partner Affiliates
|badge1| |badge2| |badge3| |badge4| |badge5|
-The field 'Contacts & Addresses' is focused on storing contact information about the company's employees and the
-company itself.
-This module adds a new field 'Affiliates' on the partner form and changes 'Contacts & Addresses'
-to only show individuals. This new field is in contrast to 'Contacts & Addresses' focussed on
-storing information about holding companies and other company structures.
+This module adds a new tab "Affiliates" in the partner form view and modifies the purpose of the tab "Contacts & Addresses". This new tab "Affiliates" is visible only if the partner is a company.
+
+The existing tab "Contacts & Addresses" in Odoo Vanilla is focused on storing contact information about the company's employees and the company itself.
+
+With this module :
+
+- The tab "Affiliates" is focused on storing information about holding companies and other company structures.
+
+- The tab "Contacts & Addresses" only shows individuals who are linked to the company (employees or others).
**Table of contents**
diff --git a/partner_affiliate/static/description/index.html b/partner_affiliate/static/description/index.html
index 627792f15..8573f1928 100644
--- a/partner_affiliate/static/description/index.html
+++ b/partner_affiliate/static/description/index.html
@@ -368,11 +368,13 @@ ul.auto-toc {
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
-The field ‘Contacts & Addresses’ is focused on storing contact information about the company’s employees and the
-company itself.
-This module adds a new field ‘Affiliates’ on the partner form and changes ‘Contacts & Addresses’
-to only show individuals. This new field is in contrast to ‘Contacts & Addresses’ focussed on
-storing information about holding companies and other company structures.
+This module adds a new tab “Affiliates” in the partner form view and modifies the purpose of the tab “Contacts & Addresses”. This new tab “Affiliates” is visible only if the partner is a company.
+The existing tab “Contacts & Addresses” in Odoo Vanilla is focused on storing contact information about the company’s employees and the company itself.
+With this module :
+
+- The tab “Affiliates” is focused on storing information about holding companies and other company structures.
+- The tab “Contacts & Addresses” only shows individuals who are linked to the company (employees or others).
+
Table of contents