📖 update docs v2

Author: ilya ilchenko

access_restricted/README.rst

@@ -2,29 +2,31 @@
    :alt: Tested and maintained by IT Projects Labs
    :target: https://itpp.dev
 
+
 Restricted administration rights
 ================================
 
-The module makes impossible for administrator to set (or see) more access rights (access groups) than he already has.
-
-It also using for restrict changes to certain settings for specific users, who should be prevented from making important changes without the knowledge of the superuser.
+The module makes impossible for **Internal User** to set (or see) more access **groups/rights** than he already has.
 
-The only partial exception if user is already a member of the **'Allow add implied groups from settings'** security group.
+Using this module, you can restrict access to changing some settings of other modules.
+For take effect it should be used with modules such as CRM, Sales etc. 
+These modules have some parameters that add access groups to the user, 
+thereby making it possible to make important changes to the functionality.
+With this module, only superuser-defined users can modify these fields.
 
-Sure, it doesn't affect to superuser rights.
 
 Typical usage of the module.
 ----------------------------
 
-This example in addition to this module installed also requires **base_setup** and **access_apps** modules.
+This example in addition to this module installed also requires our **access_apps** module.
+
+- The superuser creates an admin user without any ``Apps Access`` option in its settings.Then the administrator has access to settings, but not able to install new apps.
+
 
-1. The superuser creates an administrator user with empty parameter  **"Apps access"**.
-2. Then the administrator has access to settings, but not able to install new apps.
+- Without this module, it can change the option to ``Apps access: Allow installing apps`` and get access to apps management.
 
-* Without this module this user can add himself to **"Allow installing apps"** access group and get access to apps management.
 
-=============
+------------
 
-**Read more examples in the module's documentation.** 
 
-It was tested on `Odoo 14.0 <https://github.com/odoo/odoo/commit/c16d4b5e7b9181c2c792f595a117de10510d45be>`_
+Tested on `Odoo 14.0 <https://github.com/odoo/odoo/commit/c16d4b5e7b9181c2c792f595a117de10510d45be>`_

access_restricted/doc/index.rst

@@ -2,20 +2,6 @@
  Restricted administration rights
 ==================================
 
-Description
-============
-Using this module, you can restrict access to changing some settings of third-party modules.
-
-This module should be used with other modules that support access groups such as CRM, Sales and etc.
-
-The module makes impossible for administrator to set (or see) more access rights (access groups) than he already has.
-
-It also using for restrict changes to certain settings for specific users, who should be prevented from making important changes without the knowledge of the superuser.
-
-The only partial exception if user is already a member of the **'Allow add implied groups from settings'** security group. This user is allowed to escalate his privileges but just from Settings menus.
-
-Sure, it doesn't affect to superuser rights.
-
 Installation
 ============
 
@@ -24,42 +10,47 @@ Installation
 Configuration
 =============
 
-- IMPORTANT NOTE: 
-	By default all users except a superuser restricted to escalate the privileges
+**IMPORTANT NOTE:**  By default, all users except the superuser are restricted from changing their access gropus for escalate privileges. 
 
+It allows certain users to configure modules from ``[[ Settings ]]`` 
+menu using boolean fields which ``Field`` value starts with a **group_** 
+`(This info is displayed when hovering over the option name if developer tools is enabled)`
+
+The only users who are in special group **'Allow add implied groups from settings'** 
+have access to make changes in forbidden for others fields. 
 
 There is only one configuration option this module provides:
 
-1. Under superuser open  ``[[ Settings  ]] >> Users & Companies >> Users``  and select user's profile 
-2. In ``Access Rights`` tab you can select **'Allow add implied groups from settings'** 
-3. It allows some users to configure modules from ``[[ Settings ]]`` menus by means of boolean fields which **Field** value starts from **group_...**. (This info is displayed when hovering over the option name if developer tools is enabled)
+- Under superuser open  ``[[ Settings  ]] >> Users & Companies >> Users``  and select user's profile 
+- In ``Access Rights`` tab activate 'Allow add implied groups from settings'
 
+The user is then allowed to add additional access groups for himself 
+by using the Boolean settings fields. `(res.config.settings models views)`
+  
 Usage
 =====
-
-Let's take a few examples. 
-
-**In the first case:** we have installed this module and **Sales module** ``(sale_management)`` from ``[[ Apps ]]``.
+Let's take an example of using this module and **Sales** module (sale_management).
 
 **Without this module installed:**
 
-- Say you have a user with administration rights ``"Administration: Access Rights"``. This user thus may increase his own rights in ``"Access Rights > Sales"`` from ``"Sales: User: Own Documents Only"`` to ``"Sales: Administrator"``.
-
-**With this module installed:** 
-
-- The user from previous example cannot increase his privileges. There is no ``Sales: Administrator`` option for him, and also no ``Customer Addresses`` option in module configuration
+Say you have a user with administration rights ``Administration: Access Rights``.
+This user thus may increase his own rights in ``Access Rights > Sales`` 
+from ``Sales: User: Own Documents Only`` to ``Sales: Administrator``.
 
-The only exception is done for users who are in special group **'Allow add implied groups from settings'** they may select ``"Customer Addresses"`` from ``[[ Sales ]]`` module ``Configuration >> Settings`` menu
+Also he can open menu [[ Sales ]] >> Configuration >> Settings and 
+select Customer Addresses (**group_** sale_delivery_address) there and then click [Apply] button 
 
 
-=================
-
-
-**In another case:** we have also installed this module and also **CRM module**.
-
-* In the screenshot. the user has an access right to the settings panel from his account. (``Administration: Settings``), but is not a member of the **'Allow add implied groups from settings'** access group so it is forbidden for him to set some checkboxes in the **CRM** tab.
+**With this module installed:** 
 
-.. image:: access_restricted_screenshot.png
+The example user cannot increase their privileges.
+There is no ``Sales: Administrator`` option for it and for this reason 
+there are no module settings, including the 
+``Client Addresses`` option.
 
-* If we give him access by adding to this group, the user will have access to make changes in forbidden fields.  
+-------------
 
+To activate the ``Customer Addresses`` option, the user must be:  
+ - with administration rights `` Administration: Settings``
+   and also with ``Sales: Administrator`` rights
+ - is included in the **'Allow add implied groups from settings'** group.