diff --git a/README.textile b/README.textile
index dd6c07220..4b094162f 100644
--- a/README.textile
+++ b/README.textile
@@ -8,7 +8,7 @@ h2. Wiki
 
 Most information regarding Clearance is on the "Github Wiki":http://wiki.github.com/thoughtbot/clearance.
 
-h2. Engine
+h2. Installation
 
 Clearance is a Rails engine. It works with versions of Rails greater than 2.3.
 
@@ -40,8 +40,6 @@ Run the migration:
 
 @rake db:migrate@
 
-h2. Environment
-
 Define a HOST constant in your environment files.
 In config/environments/test.rb and config/environments/development.rb it can be:
 
@@ -82,9 +80,9 @@ rake gems:install RAILS_ENV=test
 rake gems:unpack  RAILS_ENV=test
 </pre>
 
-Don't vendor nokogiri (due to its native extensions):
+We don't vendor nokogiri due to its native extensions, so install it normally on your machine:
 
-@rm -rf vendor/gems/nokogiri-1.2.3@
+@sudo gem install nokogiri@
 
 Run the Cucumber generator (if you haven't already) and Clearance's feature generator:
 
@@ -111,9 +109,9 @@ end
 
 h2. Authors
 
-Clearance was extracted out of "Hoptoad":http://hoptoadapp.com. We merged the authentication code from two of thoughtbot's client's Rails apps and have since used it each time we need authentication. The following people have improved the library. Thank you!
+Clearance was extracted out of "Hoptoad":http://hoptoadapp.com. We merged the authentication code from two of thoughtbot's clients' Rails apps and have since used it each time we need authentication. The following people have improved the library. Thank you!
 
-Dan Croak, Mike Burns, Jason Morrison, Joe Ferris, Eugene Bolshakov, Nick Quaranto, Josh Nichols, Mike Breen, Marcel Görner, Bence Nagy, Ben Mabey, Eloy Duran, Tim Pope, Mihai Anca, Mark Cornick, & Shay Arnett.
+Dan Croak, Mike Burns, Jason Morrison, Joe Ferris, Eugene Bolshakov, Nick Quaranto, Josh Nichols, Mike Breen, Marcel Görner, Bence Nagy, Ben Mabey, Eloy Duran, Tim Pope, Mihai Anca, Mark Cornick, Shay Arnett, Joshua Clayton & Mustafa Ekim.
 
 h2. Questions?