Add some more docs about how reconnection works

Author: hamchapman

README.md

@@ -206,6 +206,16 @@ class ViewController: UIViewController, ConnectionStateChangeDelegate {
 }
 ```
 
+The different states that the connection can be in are:
+
+* `Connecting` - the connection is about to attempt to be made
+* `Connected` - the connection has been successfully made
+* `Disconnecting` - the connection has been instructed to disconnect and it is just about to do so
+* `Disconnected` - the connection has disconnected and no attempt will be made to reconnect automatically
+* `Reconnecting` - an attempt is going to be made to try and re-establish the connection
+* `ReconnectingWhenNetworkBecomesReachable` - when the network becomes reachable an attempt will be made to reconnect
+
+
 ### Reconnection
 
 There are three main ways in which a disconnection can occur:
@@ -222,6 +232,12 @@ If the Pusher servers close the websocket then the library will attempt to recon
 
 All of this is the case if you have the client option of `autoReconnect` set as `true`, which it is by default. If the reconnection strategies are not suitable for your use case then you can set `autoReconnect` to `false` and implement your own reconnection strategy based on the connection state changes.
 
+There are a couple of properties on the connection (`PusherConnection`) that you can set that affect how the reconnection behaviour works. These are:
+
+* `public var reconnectAttemptsMax: Int? = 6` - if you set this to `nil` then there is no maximum number of reconnect attempts and so attempts will continue to be made with an exponential backoff (based on number of attempts), otherwise only as many attempts as this property's value will be made before the connection's state moves to `.Disconnected`
+* `public var maxReconnectGapInSeconds: Double? = nil` - if you want to set a maximum length of time (in seconds) between reconnect attempts then set this property appropriately
+
+Note that the number of reconnect attempts gets reset to 0 as soon as a successful connection is made.
 
 ## Subscribing