"The when clause is a raw Jinja2 expression without double curly braces (see group_by_module)"

[sourcejedi]

Create the task, then add a ``when`` statement that applies a test. The ``when`` clause is a raw Jinja2 expression without double curly braces (see :ref:`group_by_module`)

File: docs/docsite/rst/playbook_guide/playbooks_conditionals.rst

I found the parenthetical confusing. group_by_module does not have any explanation about "a raw Jinja2 expression without double curly braces".

There is one mention of "when": group_by_module does not support the "when statement". But I don't know why this needs to be pointed out, in the introduction to conditionals.

I think the parenthetical could be removed?

[ansible-documentation-bot]

Thanks for your Ansible docs contribution! We talk about Ansible documentation on Matrix at #docs:ansible.im if you ever want to join us and chat about the docs! We meet on Matrix every Tuesday. See the Ansible calendar for meeting details. We welcome additions to our weekly agenda items too. You can add the dawgs-meeting tag to a forum topic to bring it up at the next meeting.

[samccann]

Thanks @sourcejedi for opening the issue... It took some real archeological digging in the git history to see where and why this changed. (For the curious - it changed with this PR).

Documentation fix:

1. Add an rst anchor at https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/rst/playbook_guide/playbooks_variables.rst?plain=1#L58 - something like jinja2_simple
2. Change the group_by_module ref at

   ansible-documentation/docs/docsite/rst/playbook_guide/playbooks_conditionals.rst

   Line 23 in bf86a30

   The simplest conditional statement applies to a single task. Create the task, then add a ``when`` statement that applies a test. The ``when`` clause is a raw Jinja2 expression without double curly braces (see :ref:`group_by_module`). When you run the task or playbook, Ansible evaluates the test for all hosts. On any host where the test passes (returns a value of True), Ansible runs that task. For example, if you are installing mysql on multiple machines, some of which have SELinux enabled, you might have a task to configure SELinux to allow mysql to run. You would only want that task to run on machines that have SELinux enabled:

   to use the new anchor introduced in step 1.

@sourcejedi we'd welcome a PR that does this if you're up for it. And thanks again for catching this! It's been around for ...ages.