README.md in whenner-0.1.1 vs README.md in whenner-0.2.0

@@ -68,19 +68,21 @@
 end.done do |titles|
   puts "Success: #{titles.inspect}"
 end
 ```
 
-As methods in Ruby can only take a single block, Whenner does not support a
-`then` method yet, that would combine the `done` and `fail` methods. This might
-be implementing in the future using something like this:
+As methods in Ruby can only take a single block, Whenner has a special block
+syntax for setting both `done` and `fail` callbacks:
 
 ```ruby
 defer { async_get('http://google.com') }.then do |on|
   on.done { puts 'Success!' }
   on.fail { puts 'Success!' }
 end
 ```
+
+The result of `Deferred#then` is a new promise for the value of the callback
+that will be run.
 
 ### Documentation
 
 See the inline [API
 docs](http://rubydoc.info/github/avdgaag/whenner/master/frames) for more