docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) #3124
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…to ansible#85897)
ansible-documentation-bot
bot
added
the
new_contributor
Contributor
|
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 |
Akasurde
requested changes
Oct 9, 2025
Akasurde
requested changes
Oct 9, 2025
GabrielOvie
temporarily deployed
to
github-bot
GitHub Actions
Inactive
Akasurde
approved these changes
Oct 10, 2025
Member
Akasurde
left a comment
Akasurde
left a comment
There was a problem hiding this comment.
LGTM will wait for others to comment.
samccann
approved these changes
Oct 20, 2025
samccann
added
backport-2.17
Backport to stable-2.17: 💚 backport PR created✅ Backport PR branch: Backported as #3155 🤖 @patchback |
patchback bot
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435)
Backport to stable-2.18: 💚 backport PR created✅ Backport PR branch: Backported as #3156 🤖 @patchback |
patchback bot
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435)
Backport to stable-2.19: 💚 backport PR created✅ Backport PR branch: Backported as #3157 🤖 @patchback |
patchback bot
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435)
Backport to stable-2.20: 💚 backport PR created✅ Backport PR branch: Backported as #3158 🤖 @patchback |
patchback bot
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435)
samccann
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) (#3155) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435) Co-authored-by: GABRIEL OVIE <ovieorezi@gmail.com>
samccann
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) (#3156) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435) Co-authored-by: GABRIEL OVIE <ovieorezi@gmail.com>
samccann
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) (#3157) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435) Co-authored-by: GABRIEL OVIE <ovieorezi@gmail.com>
samccann
pushed a commit
that referenced
this pull request
Oct 20, 2025
…to ansible#85897) (#3124) (#3158) * docs: clarify dict2items usage in loops with group module (follow-up to ansible#85897) * docs: merge dict2items group example into existing section (per review) * docs: replace tag_data example with nested server_configs dict example (per review) (cherry picked from commit 61ce435) Co-authored-by: GABRIEL OVIE <ovieorezi@gmail.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Clarifies correct
dict2itemsusage in playbook loops by showing that nested valuesmust be accessed via
item.value.*(for example,item.value.gid) when looping overa dict converted with
dict2items.Motivation
Addresses recurring confusion discussed in ansible/ansible#85897.
Changes
playbook_guide/playbooks_loops.rstwith a concise example and a “common mistake” note.Notes
A prior attempt in ansible/ansible#85964 failed sanity because
docs/docsite/rst/and
examples/are obsolete in the core repo. This PR moves the content to thecorrect documentation repository.