Documentation update

Changes.md

@@ -1,9 +1,12 @@
 HEAD
 -----------
 
-- Add `delay` extensions for ActionMailer and ActiveRecord.
-- Added config file support. See test/config.yml for an example file.
-- Added pidfile for tools like monit
+- Upon shutdown, workers are now terminated after 5 seconds.  This is to
+  meet Heroku's hard limit of 10 seconds for a process to shutdown. (mperham)
+- Refactor middleware API for simplicity, see sidekiq/middleware/chain. (mperham)
+- Add `delay` extensions for ActionMailer and ActiveRecord. (mperham)
+- Added config file support. See test/config.yml for an example file.  (jc00ke)
+- Added pidfile for tools like monit (jc00ke)
 
 0.6.0
 -----------

lib/sidekiq/middleware/chain.rb

@@ -5,28 +5,21 @@ module Sidekiq
   # (pushing jobs onto the queue) as well as the server
   # side (when jobs are actually processed).
   #
-  # Default middleware for the server:
-  #
-  # Sidekiq.server_middleware do |chain|
-  #   chain.use Middleware::Server::Airbrake
-  #   chain.use Middleware::Server::ActiveRecord
-  # end
-  #
   # To add middleware for the client:
   #
   # Sidekiq.client_middleware do |chain|
-  #   chain.use MyClientHook
+  #   chain.add MyClientHook
   # end
   #
   # To modify middleware for the server, just call
   # with another block:
   #
-  # Sidekiq::Processor.middleware do |chain|
-  #   chain.use MyServerHook
+  # Sidekiq.server_middleware do |chain|
+  #   chain.add MyServerHook
   #   chain.remove ActiveRecord
   # end
   #
-  # This is an example of a minimal middleware:
+  # This is an example of a minimal server middleware:
   #
   # class MyServerHook
   #   def call(worker, msg, queue)
@@ -36,6 +29,16 @@ module Sidekiq
   #   end
   # end
   #
+  # This is an example of a minimal client middleware:
+  #
+  # class MyClientHook
+  #   def call(msg, queue)
+  #     puts "Before push"
+  #     yield
+  #     puts "After push"
+  #   end
+  # end
+  #
   module Middleware
     class Chain
       attr_reader :entries