📖 update docs

Author: mentalko

access_restricted/doc/index.rst

@@ -2,33 +2,64 @@
  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
 ============
 
-* `Install <https://odoo-development.readthedocs.io/en/latest/odoo/usage/install-module.html>`__ this module in a usual way
+* `Install <https://odoo-development.readthedocs.io/en/latest/odoo/usage/install-module.html>`__ this module in a usual way.
 
 Configuration
 =============
 
-* By default all users except a superuser restricted to escalate the privileges
-* There is only one configuration option this module provides. Under superuser open menu ``[[ Settings  ]] >> Users & Companies >> Users``
-* In ``Access Rights`` tab you can select 'Allow add implied groups from settings' -
-  to allow some users to configure modules by means of ``group_XXX`` fields from ``Settings`` menus
+- IMPORTANT NOTE: 
+	By default all users except a superuser restricted to escalate the privileges
+
+
+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)
 
 Usage
 =====
 
-Let's take ``Sales (sale_management)`` module as an example.
+Let's take a few examples. 
+
+**In the first case:** we have installed this module and **Sales module** ``(sale_management)`` from ``[[ Apps ]]``.
+
+**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
+
+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
+
+
+=================
+
+
+**In another case:** we have also installed this module and also **CRM module**.
 
-Without this module installed:
+* 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.
 
-* Say you have a user with administration rights ``Administration: Access Rights``. This user thus may increase his own rights in ``Application Accesses`` from ``Sales: User: Own Documents Only``
-  to ``Sales: Administrator``. Also he can open menu ``[[ Sales ]] >> Configuration >> Settings`` and select ``Customer Addresses`` there
-  and then click ``[Apply]`` button (adding ``group_sale_delivery_address``)
+.. image:: access_restricted_screenshot.png
 
-With this module installed:
+* If we give him access by adding to this group, the user will have access to make changes in forbidden fields.  
 
-* The user from previous example cannot increase his privileges. There is no ``Sales: Manager`` option for him, and also no ``Customer Addresses``
-  option in module configuration
-* The only exception is done for users who are in special group 'Allow add implied groups from settings' - if your user is included in this group by the superuser then you may select
-  ``Customer Addresses`` from ``Sale`` module ``Configuration >> Settings`` menu