From b0f62062d3af793b4f789aba08f124c862e75f0f Mon Sep 17 00:00:00 2001
From: bluikko <14869000+bluikko@users.noreply.github.com>
Date: Wed, 16 Jun 2021 22:16:30 +0700
Subject: [PATCH] Async task change handling (#75020)

Async task changes should be handled in the async_status task.
---
 docs/docsite/rst/user_guide/playbooks_async.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/docsite/rst/user_guide/playbooks_async.rst b/docs/docsite/rst/user_guide/playbooks_async.rst
index 38a363bd96f..c53d06e7e40 100644
--- a/docs/docsite/rst/user_guide/playbooks_async.rst
+++ b/docs/docsite/rst/user_guide/playbooks_async.rst
@@ -119,6 +119,11 @@ If you need a synchronization point with an async task, you can register it to o
    "check on it later" task to fail because the temporary status file that
    the ``async_status:`` is looking for will not have been written or no longer exist
 
+.. note::
+   Asynchronous playbook tasks always return changed. If the task is using a module
+   that requires the user to annotate changes with ``changed_when``, ``creates``,  and so on,
+   then those should be added to the following ``async_status`` task.
+
 To run multiple asynchronous tasks while limiting the number of tasks running concurrently::
 
     #####################