README.rdoc in mail_magnet-0.1.1 vs README.rdoc in mail_magnet-0.2.0

@@ -1,16 +1,30 @@
 = Mail Magnet
 
-Mail Magnet allows you to override e-mail recipients in ActionMailer, e.g. for testing purposes.
+Mail Magnet allows you to override e-mail recipients in ActionMailer so all mails go to a given address.
+This is useful for staging environments where you want to test production-like mail delivery without sending e-mails to real users.
 
-http://gem-session.com/2010/06/overriding-e-mail-recipients-in-actionmailer
-
 == Installation
 
 Install the gem with
+
     sudo gem install mail_magnet
 
-....
+In the environment for which you'd like to override mail recipients:
+
+    config.gem 'mail_magnet'
+    config.after_initialize { ActionMailer::Base.override_recipients = '[e-mail]' }
+
+Now all e-mail sent by your ActionMailers goes to '[e-mail]' (including CC and BCC recipients).
+The original recipients will be quoted inside the mail body, like this:
+
+    - - - Original recipients - - -
+    To: [e-mail]
+    Cc: [e-mail]
+    Bcc: [e-mail]
+    - - - - - - - - - - - - - - - -
+
+    Original e-mail body goes here.
 
 == Rails 3 compatibility
 
 We cannot guarantee Rails 3 compatibility at this point, but we will upgrade the gem when Rails 3 is released.