README.markdown in ts-resque-delta-2.0.0 vs README.markdown in ts-resque-delta-2.1.0

@@ -5,74 +5,71 @@
 **This code is HEAVILY borrowed from
 [ts-delayed-delta](https://github.com/freelancing-god/ts-delayed-delta).**
 
 Installation
 ------------
+This gem depends on the following gems: _thinking-sphinx_, _resque_, and
+_resque-lock-timeout_.
 
-This gem depends on the following gems: `thinking-sphinx` and `resque`.
+    gem install ts-resque-delta
 
-Currently, you'll need Thinking Sphinx v1.5.0 (for Rails 2), v2.1.0
-(for Rails 3), or - ideally - v3.0.3 or newer (for Rails 3.1 onwards). If you're
-on a version of Thinking Sphinx that's too old, you better go upgrade - but
-otherwise, add `ts-resque-delta` to your `Gemfile` file with the rest of your
-gem dependencies:
+Add _ts-resque-delta_ to your **Gemfile** file, with the rest of your gem
+dependencies:
 
-    gem 'ts-resque-delta', '~> 2.0.0'
+    gem 'ts-resque-delta', '~> 2.1'
 
-Add the delta property to index definition. If you're using Thinking Sphinx v3,
-then it'll look something like this:
+If you're using Rails 3, the rake tasks will automatically be loaded by Rails.
+If you're using Rails 2, add the following line to your **Rakefile**:
 
-    ThinkingSphinx::Index.define(:article,
-      :with  => :active_record,
-      :delta => ThinkingSphinx::Deltas::ResqueDelta
-    ) do
-      # fields and attributes and so on...
-    end
+    require 'thinking_sphinx/deltas/resque_delta/tasks'
 
-But if you're still using v1.5 or v2.1, you'll want the following:
+Add the delta property to each `define_index` block:
 
     define_index do
-      # fields and attributes and so on...
-
+      # ...
       set_property :delta => ThinkingSphinx::Deltas::ResqueDelta
     end
 
-If you've never used delta indexes before, you'll need to add the boolean
-column named `:delta` to each table for indexed models. A database index for
-that column is also recommended.
+If you've never used delta indexes before, you'll want to add the boolean
+column named `:delta` to each model's table (note, you must set the `:default`
+value to `true`):
 
-    def change
-      add_column :articles, :delta, :boolean, :default => true, :null => false
-      add_index  :articles, :delta
+    def self.up
+      add_column :foos, :delta, :boolean, :default => true, :null => false
     end
 
+Also, I highly recommend adding a MySQL index to the table of any model using
+delta indexes. The Sphinx indexer uses `WHERE table.delta = 1` whenever the
+delta indexer runs and `... = 0` whenever the normal indexer runs. Having the
+MySQL index on the delta column will generally be a win:
+
+    def self.up
+      # ...
+      add_index :foos, :delta
+    end
+
 Usage
 -----
-
 Once you've got it all set up, all you need to do is make sure that the Resque
-worker is running. You can do this by specifying the `ts_delta` queue when
+worker is running. You can do this by specifying the `:ts_delta` queue when
 running Resque:
 
     QUEUE=ts_delta,other_queues rake resque:work
 
 Contributors (for ts-resque-delta)
 -----------------------------------
-
 * [Aaron Gibralter](https://github.com/agibralter)
 * [Ryan Schlesinger](https://github.com/ryansch) (Locking/`smart_index`)
 * [Pat Allan](https://github.com/freelancing-god) (FlyingSphinx support)
 * [James Richard](https://github.com/ketzusaka)
 
 Original Contributors (for ts-delayed-delta)
 --------------------------------------------
-
 * [Pat Allan](https://github.com/freelancing-god)
 * [Ryan Schlesinger](https://github.com/ryansch) (Allowing installs as a plugin)
 * [Maximilian Schulz](https://max.jungeelite.de) (Ensuring compatibility with Bundler)
 * [Edgars Beigarts](https://github.com/ebeigarts) (Adding intelligent description for tasks)
 * [Alexander Simonov](https://simonov.me/) (Explicit table definition)
 
 Copyright
 ---------
-
-Copyright (c) 2011-2014 Aaron Gibralter and Pat Allan, and released under an MIT
-Licence.
+Copyright (c) 2011 Aaron Gibralter, and released under an MIT Licence.