README.md in ably-0.8.15 vs README.md in ably-1.0.0

@@ -22,11 +22,11 @@
     $ bundle
 
 Or install it yourself as:
 
     $ gem install ably
-    
+
 ### Using with Rails or Sinatra
 
 This `ably` gem provides both a [Realtime](http://www.ably.io/documentation/realtime/usage) and [REST](http://www.ably.io/documentation/rest/usage) version of the Ably library. Realtime depends on EventMachine to provide an asynchronous evented framework to run the library in, whereas the REST library depends only on synchronous libraries such as Faraday.
 
 If you are using Ably within your Rails or Sinatra apps, more often than not, you probably want to use the REST only version of the library that has no dependency on EventMachine and provides a synchronous API that you will be used to using within Rails and Sinatra. [See the REST only Ruby version of the Ably library](https://github.com/ably/ably-ruby-rest).
@@ -278,9 +278,13 @@
 ```
 
 ## Dependencies
 
 If you only need to use the REST features of this library and do not want EventMachine as a dependency, then you should consider using the [Ably Ruby REST gem](https://rubygems.org/gems/ably-rest).
+
+## Upgrading from an older version
+
+- [Release and upgrade notes for v0.8 -> v1.0](https://github.com/ably/docs/issues/235)
 
 ## Support, feedback and troubleshooting
 
 Please visit http://support.ably.io/ for access to our knowledgebase and to ask for any assistance.