Doc and changelog updates

Author: jprince

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Master (Unreleased)
 
+- Update `RSpec/IteratedExpectation` cop documentation with an example of a matcher relying on block arguments. ([@jprince])
 - Fix a false negative for `RSpec/ExcessiveDocstringSpacing` when finds description with em space. ([@ydah])
 
 ## 2.22.0 (2023-05-06)

docs/modules/ROOT/pages/cops_rspec.adoc

@@ -2710,6 +2710,26 @@ end
 it 'validates users' do
   expect([user1, user2, user3]).to all(be_valid)
 end
+
+# bad
+it 'sets inferred fields for users' do
+  [user1, user2, user3].each do |user|
+    expect(user).to have_attributes(
+      post_count: PostService.new(user).post_count,
+      karma: KarmaService.new(user).value
+    )
+  end
+end
+
+# good
+it 'sets inferred fields for users' do
+  expect([user1, user2, user3]).to all(satisfy do |user|
+    have_attributes(
+      post_count: PostService.new(user).post_count,
+      karma: KarmaService.new(user).value
+    )
+  end)
+end
 ----
 
 === References

lib/rubocop/cop/rspec/iterated_expectation.rb

@@ -16,6 +16,26 @@ module RSpec
       #     expect([user1, user2, user3]).to all(be_valid)
       #   end
       #
+      #   # bad
+      #   it 'sets inferred fields for users' do
+      #     [user1, user2, user3].each do |user|
+      #       expect(user).to have_attributes(
+      #         post_count: PostService.new(user).post_count,
+      #         karma: KarmaService.new(user).value
+      #       )
+      #     end
+      #   end
+      #
+      #   # good
+      #   it 'sets inferred fields for users' do
+      #     expect([user1, user2, user3]).to all(satisfy do |user|
+      #       have_attributes(
+      #         post_count: PostService.new(user).post_count,
+      #         karma: KarmaService.new(user).value
+      #       )
+      #     end)
+      #   end
+      #
       class IteratedExpectation < Base
         MSG = 'Prefer using the `all` matcher instead ' \
               'of iterating over an array.'