diff --git a/docsite/rst/playbooks_intro.rst b/docsite/rst/playbooks_intro.rst index c5b2aebe108..ad53cb9eb47 100644 --- a/docsite/rst/playbooks_intro.rst +++ b/docsite/rst/playbooks_intro.rst @@ -365,10 +365,10 @@ The things listed in the 'notify' section of a task are called handlers. Handlers are lists of tasks, not really any different from regular -tasks, that are referenced by name. Handlers are what notifiers -notify. If nothing notifies a handler, it will not run. Regardless -of how many things notify a handler, it will run only once, after all -of the tasks complete in a particular play. +tasks, that are referenced by a globally unique name. Handlers are +what notifiers notify. If nothing notifies a handler, it will not +run. Regardless of how many things notify a handler, it will run only +once, after all of the tasks complete in a particular play. Here's an example handlers section:: @@ -382,7 +382,10 @@ 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 order written. + * Handler names live in a global namespace. + * If two handler tasks have the same name, only one will run. + `* `_ Roles are described later on. It's worthwhile to point out that handlers are automatically processed between 'pre_tasks', 'roles', 'tasks', and 'post_tasks'