diff --git a/activerecord/lib/active_record/associations.rb b/activerecord/lib/active_record/associations.rb index 4ada331c9b..22954884d7 100644 --- a/activerecord/lib/active_record/associations.rb +++ b/activerecord/lib/active_record/associations.rb @@ -605,10 +605,11 @@ def association_instance_set(name, association) # has_many :birthday_events, ->(user) { where(starts_on: user.birthday) }, class_name: 'Event' # end # - # Note: Joining and eager loading of these associations is not possible. - # These two operations happen before instance creation and the scope will be called with a +nil+ argument. - # It is allowed to be preloaded, but in the case that there's a different scope for each record, - # this will perform N+1 queries. (this is essentially the same as preloading polymorphic scopes). + # Note: Joining or eager loading such associations is not possible because + # those operations happen before instance creation. Such associations + # _can_ be preloaded, but doing so will perform N+1 queries because there + # will be a different scope for each record (similar to preloading + # polymorphic scopes). # # == Association callbacks #