[docs] Various improvements to README

- Object Notification Preferences > Silencing notifications for specific objects temporarily or permanently
- Added screenshot of widget that allows users to silence notifications
- Ensure images are displayed after headings for consistency

Author: nemesifier

README.rst

@@ -55,9 +55,10 @@ Available features
 - `Web notifications <#web-notifications>`_
 - `Email notifications <#email-notifications>`_
 - `Configurable email theme <#openwisp_notifications_email_template>`_
-- `Definition of notification types <#notification-types>`_
-- `Possibility to register new notification types <#registering--unregistering-notification-types>`_
-- `Preference for receiving notifications <#notification-preferences>`_
+- `Notification types <#notification-types>`_
+- `Registering new notification types <#registering--unregistering-notification-types>`_
+- `User notification preferences <#notification-preferences>`_
+- `Silencing notifications for specific objects temporarily or permanently <#silencing-notifications-for-specific-objects-temporarily-or-permanently>`_
 - `Automatic cleanup of old notifications <#scheduled-deletion-of-notifications>`_
 - `Configurable host for API endpoints <#openwisp_notifications_host>`_
 
@@ -346,6 +347,9 @@ web notifications:
 Notification Widget
 ~~~~~~~~~~~~~~~~~~~
 
+.. figure:: https://drive.google.com/uc?export=view&id=1EnjVxp_hjJEmUOTGyaqhd5uYCcyWnRaY
+   :align: center
+
 A javascript widget has been added to make consuming notifications easy for users.
 The notification widget provides following features:
 
@@ -355,30 +359,27 @@ The notification widget provides following features:
 - Option to filter unread notifications.
 - Option to mark all notifications as read on a single click.
 
-.. figure:: https://drive.google.com/uc?export=view&id=1EnjVxp_hjJEmUOTGyaqhd5uYCcyWnRaY
-   :align: center
-
 Notification Toasts
 ~~~~~~~~~~~~~~~~~~~
 
+.. figure:: https://drive.google.com/uc?export=view&id=1Lm0caDi3_DdiYzKc02DX3Cn2smj6ptWG
+   :align: center
+
 A notification toast delivers notifications at real-time. This allows
 users to read notifications without even opening the notification widget.
 A notification bell is also played to alert each time a notification is
 displayed through notification toast.
 
-.. figure:: https://drive.google.com/uc?export=view&id=1Lm0caDi3_DdiYzKc02DX3Cn2smj6ptWG
-   :align: center
-
 Email Notifications
 -------------------
 
+.. figure:: https://github.com/openwisp/openwisp-notifications/blob/master/docs/images/email-template.png
+
 Along with web notifications *OpenWISP Notification* also sends notifications
 through emails.
 
 Following notification email is generated by OpenWISP Notification in *OpenWISP Monitoring*:
 
-.. figure:: https://github.com/openwisp/openwisp-notifications/blob/master/docs/images/email-template.png
-
 Notification Cache
 ------------------
 
@@ -569,13 +570,13 @@ unregistered in ``ready`` method of your Django application's ``AppConfig``.
 Notification Preferences
 ------------------------
 
+.. image:: https://github.com/openwisp/openwisp-notifications/blob/master/docs/images/notification-settings.png
+
 *openwisp-notifications* allows users to select their preferred way of receiving notifications.
 Users can choose from web or email notifications. These settings have been categorized
 over notification type and organization, therefore allowing users to only receive notifications
 from selected organization or notification type.
 
-.. image:: https://github.com/openwisp/openwisp-notifications/blob/master/docs/images/notification-settings.png
-
 Notification settings are automatically created for all notification types and organizations for all users.
 While superusers can add or delete notification settings for everyone, staff users can only modify their
 preferred ways for receiving notifications. With provided functionality, users can choose to receive both
@@ -586,15 +587,21 @@ by disabling both web and email option for a notification setting.
 then ``email_notification`` or ``web_notification`` option of concerned notification type will be used
 respectively.
 
-Object Notification Preferences
--------------------------------
-*OpenWISP Notifications* allows users to even define notification preferences based on target object.
-Users can disable notifications for any object for a desired period of time.
-Using the widget on an object's admin form, a user can disable notifications for that object
-for a day, week, month or even forever.
+Silencing notifications for specific objects temporarily or permanently
+-----------------------------------------------------------------------
+
+.. image:: https://github.com/openwisp/openwisp-notifications/blob/master/docs/images/silence-notifications.png
 
-**Note**: This feature requires configuring `"OPENWISP_NOTIFICATIONS_IGNORE_ENABLED_ADMIN" <#openwisp-notifications-object-notification-widget>`_
-to enable the widget on admin site of required models.
+*OpenWISP Notifications* allows users to silence all notifications generated by
+specific objects they are not interested in for a desired period of time or even permanently,
+while other users will keep receiving notifications normally.
+
+Using the widget on an object's admin change form, a user can disable all notifications
+generated by that object for a day, week, month or permanently.
+
+**Note**: This feature requires configuring
+`"OPENWISP_NOTIFICATIONS_IGNORE_ENABLED_ADMIN" <#openwisp_notifications_ignore_enabled_admin>`_
+to enable the widget in the admin section of the required models.
 
 Scheduled deletion of notifications
 -----------------------------------
@@ -770,17 +777,17 @@ If you want cached notification content to never expire, then set it to ``None``
 Set it to ``0`` if you don't want to store notification contents in cache at all.
 
 ``OPENWISP_NOTIFICATIONS_IGNORE_ENABLED_ADMIN``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 +-----------+-----------+
 |   type    |  ``list`` |
 +-----------+-----------+
 |  default  |  []       |
 +-----------+-----------+
 
-This setting enables object notification widget on admin site of desired models which
-allows user to `disable notifications for that object. <#object-notification-preferences>`_.
-You are required to provide a list of dotted paths to desired model admin.
+This setting enables the widget which allows users to
+`silence notifications for specific objects temporarily or permanently. <#silencing-notifications-for-specific-objects-temporarily-or-permanently>`_
+in the change page of the specified ``ModelAdmin`` classes.
 
 E.g., if you want to enable the widget for objects of ``openwisp_users.models.User``
 model, then configure the setting as following: