Update docs [ci-skip]

Author: kzaitsev

README.md

@@ -39,9 +39,9 @@ gem 'grape-swagger-entity'
 gem 'grape-swagger-representable'
 ```
 
-##### Custom model parser interface
+##### Custom Model Parsers
 
-You can create your own model parser, for example for [roar](https://github.com/apotonick/roar)
+You can create your own model parser, for example for [roar](https://github.com/apotonick/roar).
 
 ```rb
 module GrapeSwagger
@@ -63,35 +63,27 @@ module GrapeSwagger
 end
 ```
 
-Then you should register your custom parser:
+Then you should register your custom parser.
 
 ```rb
 GrapeSwagger.model_parsers.register(GrapeSwagger::Roar::Parser, Roar::Decorator)
 ```
 
-To controll model parsers sequence, you can insert your Parser before or after another parser
+To control model parsers sequence, you can insert your parser before or after another parser.
 
-before:
+#### insert_before
 
 ```rb
-if defined?(GrapeSwagger::Representable::Parser)
-  GrapeSwagger.model_parsers.insert_before(GrapeSwagger::Representable::Parser, GrapeSwagger::Roar::Parser, Roar::Decorator)
-else
-  GrapeSwagger.model_parsers.register(GrapeSwagger::Roar::Parser, Roar::Decorator)
-end
+GrapeSwagger.model_parsers.insert_before(GrapeSwagger::Representable::Parser, GrapeSwagger::Roar::Parser, Roar::Decorator)
 ```
 
-after:
+#### insert_after
 
 ```rb
-if defined?(GrapeSwagger::Roar::Parser)
-  GrapeSwagger.model_parsers.insert_after(GrapeSwagger::Roar::Parser, GrapeSwagger::Representable::Parser, Representable::Decorator)
-else
-  GrapeSwagger.model_parsers.register(GrapeSwagger::Representable::Parser, Representable::Decorator)
-end
+GrapeSwagger.model_parsers.insert_after(GrapeSwagger::Roar::Parser, GrapeSwagger::Representable::Parser, Representable::Decorator)
 ```
 
-As we know, `Roar::Decorator` uses as superclass `Representable::Decorator`, this allow to avoid problem when Roar objects will be processed by `GrapeSwagger::Representable::Parser`, instead `GrapeSwagger::Roar::Parser`
+As we know, `Roar::Decorator` uses as superclass `Representable::Decorator`, this allow to avoid problem when Roar objects will be processed by `GrapeSwagger::Representable::Parser`, instead `GrapeSwagger::Roar::Parser`.
 
 <a name="related" />
 ## Related Projects
@@ -110,10 +102,10 @@ The following versions of grape, grape-entity and grape-swagger can currently be
 
 grape-swagger | swagger spec | grape                   | grape-entity | representable |
 --------------|--------------|-------------------------|--------------|---------------|
-0.10.5        |     1.2      | >= 0.10.0 ... <= 0.14.0 |  < 0.5.0     | Unsupported   |
-0.11.0        |     1.2      |               >= 0.16.2 |  < 0.5.0     | Unsupported   |
-0.20.1        |     2.0      | >= 0.12.0 ... <= 0.14.0 | <= 0.5.1     | Unsupported   |
-0.20.3        |     2.0      | >= 0.12.0 ... ~> 0.16.2 | ~> 0.5.1     | Unsupported   |
+0.10.5        |     1.2      | >= 0.10.0 ... <= 0.14.0 |  < 0.5.0     | n/a           |
+0.11.0        |     1.2      |               >= 0.16.2 |  < 0.5.0     | n/a           |
+0.20.1        |     2.0      | >= 0.12.0 ... <= 0.14.0 | <= 0.5.1     | n/a           |
+0.20.3        |     2.0      | >= 0.12.0 ... ~> 0.16.2 | ~> 0.5.1     | n/a           |
 0.21.0 (next) |     2.0      | >= 0.12.0 ... <= 0.16.2 | <= 0.5.1     | >= 2.4.1      |
 
 <a name="swagger-spec" />

UPGRADING.md

@@ -1,6 +1,15 @@
 Upgrading Grape-swagger
 =======================
 
+### Upgrading to >= 0.21.0
+
+With grape >= 0.21.0, `grape-entity` support moved to separate gem `grape-swagger-entity`, if you use grape entity, update your Gemfile:
+
+```ruby
+gem 'grape-swagger'
+gem 'grape-swagger-entity'
+```
+
 ### Upgrading to >= 0.10.2
 
 With grape >= 0.12.0, support for `notes` is replaced by passing a block `detail` option specified. For future compatibility, update your code: