Merge pull request #12849 from bborysenko/docsite/handlers_order

Fix order of handlers that were notified in different sections

docsite/rst/playbooks_intro.rst

@@ -387,10 +387,12 @@ won't need them for much else.
    * If two handler tasks have the same name, only one will run.
      `* <https://github.com/ansible/ansible/issues/4943>`_
 
-Roles are described later on.  It's worthwhile to point out that handlers are
+Roles are described later on, but it's worthwhile to point out that:
-automatically processed between ``pre_tasks``, ``roles``, ``tasks``, and ``post_tasks``
+
-sections.  If you ever want to flush all the handler commands immediately though,
+* handlers notified within ``pre_tasks``, ``tasks``, and ``post_tasks`` sections are automatically flushed in the end of section where they were notified;
-in 1.2 and later, you can::
+* handlers notified within ``roles`` section are automatically flushed in the end of ``tasks`` section, but before any ``tasks`` handlers.
+
+If you ever want to flush all the handler commands immediately though, in 1.2 and later, you can::
 
     tasks:
        - shell: some tasks go here