Document with with an example an link to Parameterized

Also change the class_methods to ClassMethods since the former document
the method as an instance method of Parameterized not as a class method.

1 files changed, 6 insertions, 1 deletions

diff --git a/actionmailer/lib/action_mailer/parameterized.rb b/actionmailer/lib/action_mailer/parameterized.rb
index 1c6e5da9fe..3acacc1f14 100644
--- a/actionmailer/lib/action_mailer/parameterized.rb
+++ b/actionmailer/lib/action_mailer/parameterized.rb
@@ -89,7 +89,12 @@ module ActionMailer
       attr_accessor :params
     end
 
-    class_methods do
+    module ClassMethods
+      # Provide the parameters to the mailer in order to use them in the instance methods and callbacks.
+      #
+      #   InvitationsMailer.with(inviter: person_a, invitee: person_b).account_invitation.deliver_later
+      #
+      # See Parameterized documentation for full example.
       def with(params)
         ActionMailer::Parameterized::Mailer.new(self, params)
       end