UPGRADING.md in slack-ruby-client-0.8.1 vs UPGRADING.md in slack-ruby-client-0.9.0

- old
+ new

@@ -1,7 +1,23 @@ Upgrading Slack-Ruby-Client =========================== +### Upgrading to >= 0.9.0 + +#### Changes in How the RTM Client Connects + +The RealTime client now automatically chooses either [rtm.start](https://api.slack.com/methods/rtm.start) or [rtm.connect](https://api.slack.com/methods/rtm.connect) to open a connection. The former retrieves a lot of team information while the latter only serves connection purposes and is newer and preferred, while the latter is required to use the full `Slack::RealTime::Stores::Store` storage class. + +Prior versions always used `rtm.start`, to restore this behavior, configure `start_method`. + +```ruby +Slack::RealTime::Client.config do |config| + config.start_method = :rtm_start +end +``` + +See [#145](https://github.com/slack-ruby/slack-ruby-client/pull/145) for more information. + ### Upgrading to >= 0.8.0 The default timeout for `rtm.start` has been increased from 60 to 180 seconds via `Slack::RealTime::Client.config.start_options[:request][:timeout]`. If you're explicitly setting `start_options` in your application, preserve the value by merging settings instead of replacing the entire `start_options` value. Before: