Rework notes

4.0-Upgrade.md

@@ -1,19 +1,7 @@
-# Upgrading to Sidekiq 4.0
+# Welcome to Sidekiq 4.0!
 
-Sidekiq 4.0 contains a completely redesigned core with much higher
-performance.  See my blog for [an overview of Sidekiq 4's higher performance](http://www.mikeperham.com/2015/10/14/optimizing-sidekiq/).
-
-To upgrade cleanly:
-
-* Upgrade to the latest Sidekiq 3.x.
-```ruby
-gem 'sidekiq', '< 4'
-```
-* Fix any deprecation warnings you see.
-* Upgrade to 4.0.x.
-```ruby
-gem 'sidekiq', '< 5'
-```
+Sidekiq 4.0 contains a redesigned, more efficient core with less overhead per job.
+See my blog for [an overview of Sidekiq 4's higher performance](http://www.mikeperham.com/2015/10/14/optimizing-sidekiq/).
 
 ## What's New
 
@@ -28,10 +16,24 @@ gem 'redis-namespace'
 
 * **Redis 2.8.0 or greater is required.**  Redis 2.8 was released two years
   ago and contains **many** useful features which Sidekiq couldn't
-  leverage until now.  Redis 3.0.3 or greater is recommended for large
+  leverage until now.  **Redis 3.0.3 or greater is recommended** for large
   scale use.
 
 * Sidekiq requires more Redis connections per process due to a change in
   how jobs are fetched from Redis.  You must have a minimum of
   `concurrency + 2` connections in your pool or Sidekiq will exit.
   When in doubt, let Sidekiq size the connection pool for you.
+
+## Upgrade
+
+First, make sure you are using Redis 2.8 or greater. Next:
+
+* Upgrade to the latest Sidekiq 3.x.
+```ruby
+gem 'sidekiq', '< 4'
+```
+* Fix any deprecation warnings you see.
+* Upgrade to 4.x.
+```ruby
+gem 'sidekiq', '< 5'
+```