Update readme

README.md

@@ -28,6 +28,7 @@ asynchronous code up to the next level.
   * [Fail](#fail)
   * [Always](#always)
   * [Then](#then)
+  * [Recover](#recover)
   * [When](#when)
 * [Installation](#installation)
 * [Author](#author)
@@ -229,6 +230,26 @@ promise2.thenInBackground({ data -> Promise<NSData> in
 })
 ```
 
+### Recover
+Returns a new ***promise*** that can be used to continue the chain when an
+error was thrown.
+
+```swift
+let promise = Promise<String>()
+// Recover the chain
+promise
+  .recover({ error -> Promise<String> in
+    return Promise({
+      return "Recovered"
+    })
+  })
+  .done({ string in
+    print(string) // Recovered
+  })
+// Reject the promise
+promise.reject(Error.notFound)
+```
+
 ### When
 Provides a way to execute callback functions based on one or more
 ***promises***. The ***when*** method returns a new "master" ***promise*** that

Sources/When/Promise.swift

@@ -222,13 +222,19 @@ extension Promise {
 // MARK: - Recover
 
 extension Promise {
+  /**
+   Helps to recover from certain errors. Continues the chain if a given closure does not throw.
+   */
   public func recover(on queue: DispatchQueue = mainQueue,
                       _ body: @escaping (Error) throws -> T) -> Promise<T> {
     let promise = Promise<T>(queue: queue)
     addRecoverObserver(on: queue, promise: promise, body)
     return promise
   }
 
+  /**
+   Helps to recover from certain errors. Continues the chain if a given closure does not throw.
+   */
   public func recover(on queue: DispatchQueue = mainQueue,
                       _ body: @escaping (Error) throws -> Promise<T>) -> Promise<T> {
     let promise = Promise<T>(queue: queue)
@@ -243,6 +249,9 @@ extension Promise {
     return promise
   }
 
+  /**
+   Adds a recover observer.
+   */
   private func addRecoverObserver(on queue: DispatchQueue, promise: Promise<T>,
                                   _ body: @escaping (Error) throws -> T?) {
     observer = Observer(queue: queue) { result in