README.md in humanizer-2.5.0 vs README.md in humanizer-2.6.0

@@ -1,37 +1,53 @@
 # Humanizer
 
-Humanizer is a very simple CAPTCHA method. It has a localized YAML file with questions and answers which is used to validate that the user is an actual human. Any model that includes ActiveModel::Validations should work. Our aim is to be database and mapper agnostic, so if it doesn't work for you, open an issue. Humanizer only works with Rails 3.
+Humanizer is a very simple CAPTCHA method. It has a localized YAML file with questions and answers which is used to validate that the user is an actual human. Any model that includes ActiveModel::Validations should work. Our aim is to be database and mapper agnostic, so if it doesn't work for you, open an issue. Humanizer works with Rails 3 and 4.
 
 ## Installation
 
-1. `gem install humanizer`
-2. `rails g humanizer`
+Add `humanizer` to your Gemfile:
 
+```ruby
+gem 'humanizer'
+```
+
+Bundle and run the generator in terminal:
+
+```sh
+bundle
+rails g humanizer
+```
+
 ## Advanced Installation
 
 * Install all locales: `rails g humanizer --all-locales`
 * Show available locales: `rails g humanizer --show-locales`
 * Install selected locales: `rails g humanizer en fi de`
 
 ## Usage
 
 1. In your model, include Humanizer and add the #require_human_on method, example:
 
-        class User < ActiveRecord::Base
-          include Humanizer
-          require_human_on :create
-        end
+```ruby
+class User < ActiveRecord::Base
+  include Humanizer
+  require_human_on :create
+end
+```
 
 2. Ask the question in the form, example:
 
-        <%= f.label :humanizer_answer, @model.humanizer_question %>
-        <%= f.text_field :humanizer_answer %>
-        <%= f.hidden_field :humanizer_question_id %>
+```erb
+<%= f.label :humanizer_answer, @model.humanizer_question %>
+<%= f.text_field :humanizer_answer %>
+<%= f.hidden_field :humanizer_question_id %>
+```
 
 3. If you are using attr_accessible, remember to whitelist `:humanizer_answer` and `:humanizer_question_id`.
 
+4. If you are using strong_parameters, remember to permit `:humanizer_answer` and `:humanizer_question_id`.
+
 ## Configuration
 
 Default translations can be found in config/locales/
 
 You might want to add/change question and answer pairs. This can be easily done by adding/modifying entries in locales file.
@@ -40,22 +56,26 @@
 
 You might want to skip the humanizer validations on your tests or rails console.
 
 You can just have a simple attribute on your model and use it to bypass the validation. Here's an example:
 
-    attr_accessor :bypass_humanizer
-    require_human_on :create, :unless => :bypass_humanizer
+```ruby
+attr_accessor :bypass_humanizer
+require_human_on :create, :unless => :bypass_humanizer
+```
 
 Now when bypass_humanizer is true, validation will be skipped.
 
 ## Reloading questions
 
 In case you want to give your users the option to change the question, there's a #change_humanizer_question method to help you.
 
 To make sure the current question doesn't get asked again, you can pass the current question id to the method. For example:
 
-    @user.change_humanizer_question(params[:user][:humanizer_question_id])
-          
+```ruby
[e-mail]_humanizer_question(params[:user][:humanizer_question_id])
+```
+
 ## Live sites
 
 * [ArcticStartup.com](http://arcticstartup.com/) - sign up form
 * [Paspartout](http://paspartout.com/) - sign up form