diff --git a/README.md b/README.md
index 84887a549..dd3710db2 100644
--- a/README.md
+++ b/README.md
@@ -35,24 +35,29 @@ gem 'acts-as-taggable-on'
 
 and bundle:
 
-```ruby
+```shell
 bundle
 ```
 
 #### Post Installation
 
-```shell
-# For the latest versions
-rake railties:install:migrations FROM=acts_as_taggable_on_engine db:migrate
+Install migrations
 
-# For versions 2.4.1 and earlier
+```shell
+# For the latest versions :
+rake acts_as_taggable_on_engine:install:migrations
+# For versions 2.4.1 and earlier :
 rails generate acts_as_taggable_on:migration
+```
+
+Review the generated migrations then migrate :
+```shell
 rake db:migrate
 ```
 
 #### Upgrading
 
-see [UPGRADING](UPGRADING)
+see [UPGRADING](UPGRADING.md)
 
 ## Usage
 
@@ -357,4 +362,4 @@ You can run all the tests across all the Rails versions by running `rake apprais
 
 ## License
 
-See [LICENSE](https://github.com/mbleigh/acts-as-taggable-on/blob/master/LICENSE.md)
+See [LICENSE](https://github.com/mbleigh/acts-as-taggable-on/blob/master/LICENSE.md)
\ No newline at end of file
diff --git a/UPGRADING b/UPGRADING.md
similarity index 57%
rename from UPGRADING
rename to UPGRADING.md
index ea282fa64..76650a785 100644
--- a/UPGRADING
+++ b/UPGRADING.md
@@ -2,6 +2,6 @@ When upgrading
 
 Re-run the migrations generator
 
-    rake railties:install:migrations FROM=acts_as_taggable_on_engine db:migrate
+    rake acts_as_taggable_on_engine:install:migrations
 
 It will create any new migrations and skip existing ones
diff --git a/acts-as-taggable-on.gemspec b/acts-as-taggable-on.gemspec
index 2170861fa..9a96a927c 100644
--- a/acts-as-taggable-on.gemspec
+++ b/acts-as-taggable-on.gemspec
@@ -18,8 +18,8 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 
-  if File.exists?('UPGRADING')
-    gem.post_install_message = File.read('UPGRADING')
+  if File.exists?('UPGRADING.md')
+    gem.post_install_message = File.read('UPGRADING.md')
   end
 
   gem.add_runtime_dependency 'rails', ['>= 3', '< 5']