README.md in wordnik-4.06.04 vs README.md in wordnik-4.06.05

@@ -7,76 +7,75 @@
 ruby gem.
 
 Installation
 ------------
 
-### Rails 3.x
+```bash
+gem install wordnik
+```
 
-Add the wordnik gem to your Gemfile.rb:
+Or, add the wordnik gem to your project's Gemfile.rb:
 
-    gem 'wordnik'
+```ruby
+gem 'wordnik'
+```
 
-Then from your project's RAILS_ROOT, run:
+Then from your project's root, run:
 
-    bundle install
+```bash
+bundle
+```
 
-Create a file named config/initializers/wordnik.rb and drop this in:
+If you're using Wordnik in a rails app, drop this into `config/initializers/wordnik.rb`:
 
-	Wordnik.configure do |config|
-		config.api_key = '12345abcde'			# required
-		config.username = 'bozo'					# optional, but needed for user-related functions
-		config.password = 'cl0wnt0wn'			# optional, but needed for user-related functions
-		config.response_format = :json		# defaults to json, but xml is also supported
-	end
+```ruby
+Wordnik.configure do |config|
+  config.api_key = '12345abcde'     # required
+  config.username = 'bozo'          # optional, but needed for user-related functions
+  config.password = 'cl0wnt0wn'     # optional, but needed for user-related functions
+  config.response_format = :json    # defaults to json, but xml is also supported
+end
+```
+	
+Example Usage
+-------------
 
-### Rails 2.x
+```ruby
+%w(rubygems wordnik).each {|lib| require lib}
 
-Add the wordnik gem to your app. In config/environment.rb:
+Wordnik.configure do |config|
+	config.api_key = 'YOUR_API_KEY_HERE'
+end
 
-    config.gem 'wordnik'
+# Definitions
+Wordnik.word.get_definitions('hysterical')
+Wordnik.word.get_definitions('lemurs', :use_canonical => true)
+Wordnik.word.get_definitions('fish', :part_of_speech => 'verb,noun')
+Wordnik.word.get_definitions('scoundrel', :limit => 20, :source_dictionaries => "ahd,wiktionary,wordnet")
 
-Then from your project's RAILS_ROOT, run:
+# Examples
+Wordnik.word.get_examples('slovenly')
+Wordnik.word.get_examples('wrangle', :limit => 10, :skip => 10) # pagination
 
-    rake gems:install
-    rake gems:unpack GEM=wordnik
+# Related Words
+Wordnik.word.get_related_words('sad', :type => 'synonym')
+Wordnik.word.get_related_words('bowls', :type => 'hypernym', :use_canonical => true)
 
-Create config/initializers/wordnik.rb and drop this in:
+# Search
+Wordnik.words.search_words(:query => 'dog')
+Wordnik.words.search_words(:query => 'cal*', :min_dictionary_count => 3)
+Wordnik.words.search_words(:query => '*tin*', :include_part_of_speech => 'verb', :min_length => 5, :max_length => 20)
 
-	Wordnik.configure do |config|
-		config.api_key = '12345abcde'
-		config.response_format = :json # defaults to json, but xml is also supported
-	end
-	
-### Sinatra/Padrino/Other
+```
 
-	gem install wordnik
+For a full list of available methods, check out the [Wordnik API documentation](http://developer.wordnik.com/docs).
+When you make a request using our web-based API sandbox, the response output will show you how to make the 
+[equivalent ruby request](http://cl.ly/9FQY). w00t!
 
-Put this somewhere in your app's initialization process:
-
-	Wordnik.configure do |config|
-		config.api_key = '12345abcde'
-		config.response_format = :json # defaults to json, but xml is also supported
-	end
-	
-	
-Usage
------
-
-	# The clean version..
-	examples = Wordnik.word.get_examples('monkey', :limit => 50, :part_of_speech => 'verb')
-	
-	# ..and its low-level equivalent
-	request = Wordnik::Request.new(:get, '/word/{word}/examples', :params => {:word => 'monkey', :limit => 50, :part_of_speech => 'verb'})
-	examples = request.response.body
-	
-      request1 = Wordnik.word_list.get_word_list_by_id('dog', :request_only => true)
-
-For a full list of methods, checkout [USAGE.md](https://github.com/wordnik/wordnik-ruby/blob/master/USAGE.md). The wordnik gem automatically generates its convenience methods by parsing the [Wordnik API documentation](http://developer.wordnik.com/docs).
-
 Specs
 -----
 
-The wordnik gem uses rspec 2. To run the test suite, just type `rake` or `rake spec` in the gem's base directory.
+The wordnik gem uses rspec 2. To run the test suite, just type `rake` or `bundle exec rake spec` in the gem's base directory.
 	
 Contributing
 ------------
 
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
\ No newline at end of file