Add a note for --start-at-task

[Akasurde]

SUMMARY

add a note stating what --start-at-task can and cannot address

Signed-off-by: Abhijeet Kasurde [email protected]

ISSUE TYPE

• Docs Pull Request

[bcoca]

within imports (which are static) .. dont say 'static includes' as that would be a contradiction in our terminology, in which all includes are dynamic

[bcoca]

same with below, just establish import == static/preprocessed, include ==dynamic/executed at runtime

[oraNod]

@Akasurde Hi, is this still something we should consider or is it better to close? I've taken a stab at the wording. Hopefully it helps. Cheers.

[oraNod]

Suggested change

	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`.
	In this example, Ansible starts executing your playbook at a task named "install packages".

[oraNod]

Suggested change

	Moreover, ``--start-at-task``
	The ``--start-at-task`` feature does not work with reused tasks in all cases. This depends on if the reuse is dynamic or static.
	- If dynamically reused with an ``include_*`` statement, ``--start-at-task`` can target the task itself but not tasks inside the included role or task.
	- If statically reused with an ``import_*`` statement, ``--start-at-task`` can target tasks inside the imported role or task but not the task itself.
	For more information about are inside roles or tasks (), see :ref:`dynamic_vs_static`.

[oraNod]

Hi @Akasurde We've made some changes to the underlying readthedocs project for this repository. I'm going to close and re-open this issue to kick off a new PR preview build.

You might notice there will be two checks for readthedocs. One for docs/readthedocs.org:stage-ansible-core and another for docs/readthedocs.org:ansible-core.

The stage-ansible-core check is for the old project and will result in a 404. Please ignore that and use the ansible-core check only.

Thank you for your patience and understanding.