From 18d58e42d51bb84ca6d28d2e521f33859bcabe8c Mon Sep 17 00:00:00 2001
From: Dag Wieers <dag@wieers.com>
Date: Thu, 3 Mar 2016 14:32:56 +0100
Subject: [PATCH] Improve ambiguous statement regarding handler order

This fixes #10064
---
 docsite/rst/playbooks_intro.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docsite/rst/playbooks_intro.rst b/docsite/rst/playbooks_intro.rst
index e43dfd475a7..8ae7e82b4a4 100644
--- a/docsite/rst/playbooks_intro.rst
+++ b/docsite/rst/playbooks_intro.rst
@@ -382,7 +382,7 @@ Handlers are best used to restart services and trigger reboots.  You probably
 won't need them for much else.
 
 .. note::
-   * Notify handlers are always run in the order written.
+   * Notify handlers are always run in the same order they are parsed by Ansible, `not` in the order listed in the notify-statement.
    * Handler names live in a global namespace.
    * If two handler tasks have the same name, only one will run.
      `* <https://github.com/ansible/ansible/issues/4943>`_