coderberry
diff --git a/‎.rubocop_todo.yml
+3-2 b/‎.rubocop_todo.yml
+3-2
diff --git a/‎CHANGELOG.md
+2-1 b/‎CHANGELOG.md
+2-1
diff --git a/‎README.md
+53 b/‎README.md
+53
diff --git a/‎UPGRADING.md
+12-3 b/‎UPGRADING.md
+12-3
@@ -50,7 +50,6 @@ Metrics/CyclomaticComplexity:
 # URISchemes: http, https
 Metrics/LineLength:
   Max: 215
-
 # Offense count: 57
 # Configuration parameters: CountComments.
 Metrics/MethodLength:
@@ -60,6 +59,8 @@ Metrics/MethodLength:
 # Configuration parameters: CountComments.
 Metrics/ModuleLength:
   Max: 212
+  Exclude:
+    - 'spec/grape/dsl/routing_spec.rb'
 
 # Offense count: 21
 Metrics/PerceivedComplexity:
@@ -87,7 +88,7 @@ Naming/HeredocDelimiterNaming:
 # Configuration parameters: AutoCorrect.
 Performance/HashEachMethods:
   Exclude:
-    - 'lib/grape/api.rb'
+    - 'lib/grape/api/instance.rb'
     - 'lib/grape/middleware/versioner/header.rb'
 
 # Offense count: 1
 
@@ -1,8 +1,9 @@
-### 1.1.1 (Next)
+### 1.2.0 (Next)
 
 #### Features
 
 * Your contribution here.
+* [#1795](https://github.com/ruby-grape/grape/pull/1803): Adds the ability to re-mount all endpoints in any location - [@myxoh](https://github.com/bschmeck).
 * [#1795](https://github.com/ruby-grape/grape/pull/1795): Fix vendor/subtype parsing of an invalid Accept header - [@bschmeck](https://github.com/bschmeck).
 * [#1791](https://github.com/ruby-grape/grape/pull/1791): Support `summary`, `hidden`, `deprecated`, `is_array`, `nickname`, `produces`, `consumes`, `tags` options in `desc` block - [@darren987469](https://github.com/darren987469).
 
 
@@ -22,6 +22,8 @@
   - [Alongside Sinatra (or other frameworks)](#alongside-sinatra-or-other-frameworks)
   - [Rails](#rails)
   - [Modules](#modules)
+- [Remounting](#remounting)
+  - [Configuration](#configuration)
 - [Versioning](#versioning)
   - [Path](#path)
   - [Header](#header)
@@ -366,6 +368,57 @@ class Twitter::API < Grape::API
 end
 ```
 
+## Remounting
+
+You can mount the same endpoints in two different locations.
+
+```ruby
+class Voting::API < Grape::API
+  namespace 'votes' do
+    get do
+      # Your logic
+    end
+
+    post do
+      # Your logic
+    end
+  end
+end
+
+class Post::API < Grape::API
+  mount Voting::API
+end
+
+class Comment::API < Grape::API
+  mount Voting::API
+end
+```
+
+Assuming that the post and comment endpoints are mounted in `/posts` and `/comments`, you should now be able to do `get /posts/votes`, `post /posts/votes`, `get /comments/votes`.
+
+### Configuration
+
+You can configure remountable endpoints for small details changing according to where they are mounted.
+
+```ruby
+class Voting::API < Grape::API
+  namespace 'votes' do
+    desc "Vote for your #{configuration[:votable]}"
+    get do
+      # Your logic
+    end
+  end
+end
+
+class Post::API < Grape::API
+  mount Voting::API, with: { votable: 'posts' }
+end
+
+class Comment::API < Grape::API
+  mount Voting::API, with: { votable: 'comments' }
+end
+```
+
 ## Versioning
 
 There are four strategies in which clients can reach your API's endpoints: `:path`,
 
@@ -1,7 +1,16 @@
 Upgrading Grape
 ===============
 
-### Upgrading to >= 1.1.1
+### Upgrading to >= 1.2.0
+
+#### Changes in the Grape::API class
+
+In an effort to make APIs re-mountable, The class `Grape::API` no longer refers to an API instance,
+rather, what used to be `Grape::API` is now `Grape::API::Instance` and `Grape::API` was replaced
+with a class that can contain several instances of `Grape::API`.
+
+This changes were done in such a way that no code-changes should be required.
+However, if experiencing problems, or relying on private methods and internal behaviour too deeply, it is possible to restore the prior behaviour by replacing the references from `Grape::API` to `Grape::API::Instance`.
 
 #### Changes in rescue_from returned object
 
@@ -10,9 +19,9 @@ Grape will now check the object returned from `rescue_from` and ensure that it i
 ```ruby
 class Twitter::API < Grape::API
   rescue_from :all do |e|
-    # version prior to 1.1.1
+    # version prior to 1.2.0
     Rack::Response.new([ e.message ], 500, { 'Content-type' => 'text/error' }).finish
-    # 1.1.1 version
+    # 1.2.0  version
     Rack::Response.new([ e.message ], 500, { 'Content-type' => 'text/error' })
   end
 end