diff --git a/activerecord/lib/active_record/associations.rb b/activerecord/lib/active_record/associations.rb
index 659e512ce2f8fc527b123419797fe59df4e4f01c..dc68b013868110dd20e647e28d7c7a41f964a325 100644
--- a/activerecord/lib/active_record/associations.rb
+++ b/activerecord/lib/active_record/associations.rb
@@ -1296,6 +1296,12 @@ module ClassMethods
# If using with the :through option, the association on the join model must be
# a #belongs_to, and the records which get deleted are the join records, rather than
# the associated records.
+ #
+ # If using dependent: :destroy on a scoped association, only the scoped objects are destroyed.
+ # For example, if a Post model defines
+ # has_many :comments, -> { where published: true }, dependent: :destroy and destroy is
+ # called on a post, only published comments are destroyed. This means that any unpublished comments in the
+ # database would still contain a foreign key pointing to the now deleted post.
# [:counter_cache]
# This option can be used to configure a custom named :counter_cache. You only need this option,
# when you customized the name of your :counter_cache on the #belongs_to association.