diff --git a/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst b/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst index 22fade9760e..77593ab1d94 100644 --- a/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst +++ b/docs/docsite/rst/playbook_guide/playbooks_startnstep.rst @@ -19,6 +19,14 @@ To start executing your playbook at a particular task (usually the task that fai In this example, Ansible starts executing your playbook at a task named "install packages". This feature does not work with tasks inside dynamically re-used roles or tasks (``include_*``), see :ref:`dynamic_vs_static`. +.. note:: + + Moreover, ``--start-at-task`` + - can target tasks **within** static includes + - cannot target tasks **within** dynamic includes + - can target the dynamic include task itself + - cannot target the static include task itself + .. _step: Step mode