Updated readme.

Author: Bilge

README.md

@@ -7,6 +7,8 @@ Retry
 [![Code style][Style image]][Style]
 
 Retry provides a function to retry failing operations. An operation is deemed to have failed if it throws an exception.
+This library is a rewrite of [Igor Wiedler's retry](https://github.com/igorw/retry) but aims to remain faithful to the
+spirit of the original.
 
 Requirements
 ------------
@@ -17,18 +19,19 @@ Requirements
 Usage
 -----
 
-The `retry` function has the following signature.
+The `retry` function retries an operation up to the specified number of times with an optional error handler and has
+the following signature.
 
 ```
 retry(int $times, callable $operation, callable $onError = null);
 ```
-* `$times` specifies how many times the operation may be called.
-* `$operation` is a callback to be run up to the specified number of times.
-* `$onError` is called immediately before retrying the operation.
+* `$times`—Maximum number of times the operation may run.
+* `$operation`—Operation to run up to the specified number of times.
+* `$onError`—Optional. Error handler called immediately before retrying the operation.
 
-Note that in the [original library](https://github.com/igorw/retry), `$times` specified the number of *retries* and
-therefore the operation could run up to `n + 1` times. In this version, `$times` specifies exactly the number of
-times the operation may run such that if zero (`0`) is specified it will never run.
+Note in the original library, `$times` specifies the number of *retries* and therefore the operation could run up to
+`$times + 1` times. In this version, `$times` specifies exactly the number of times the operation may run such that if
+zero (`0`) is specified it will not run.
 
 ### Example