Update README and gemspec

README.md

@@ -40,6 +40,15 @@ end
 
 It will look for you main doc file under `/public/api_docs` path.
 
+## Config options
+Config Name | Swagger parameter name | Description
+--- | --- | ---
+config.swagger_url | url | The url pointing to `swagger.json` (Swagger 2.0) or the resource listing (earlier versions) as per [OpenAPI Spec](https://github.com/OAI/OpenAPI-Specification/).
+config.doc_expansion | docExpansion | Controls how the API listing is displayed. It can be set to 'none' (default), 'list' (shows operations for each resource), or 'full' (fully expanded: shows operations and their details).
+config.model_rendering | defaultModelRendering | Controls how models are shown when the API is first rendered. (The user can always switch the rendering for a given model by clicking the 'Model' and 'Model Schema' links.) It can be set to 'model' or 'schema', and the default is 'schema'.
+config.request_headers | showRequestHeaders | Whether or not to show the headers that were sent when making a request via the 'Try it out!' option. Defaults to `false`.
+config.json_editor | jsonEditor | Enables a graphical view for editing complex bodies.  Defaults to `false`.
+
 ### Edit your json/yaml files
 
 Use [Swagger editor](https://github.com/swagger-api/swagger-editor).

swagger_ui_engine.gemspec

@@ -10,8 +10,8 @@ Gem::Specification.new do |s|
   s.authors     = ['ZuzannaSt']
   s.email       = ['[email protected]']
   s.homepage    = 'https://github.com/ZuzannaSt/swagger_ui_engine'
-  s.summary     = 'Mount swagger-ui as rails engine.'
-  s.description = 'Api docs inside your rails project.'
+  s.summary     = 'Mount Swagger-Ui as Rails engine.'
+  s.description = 'Swagger API docs and web console for your rails project.'
   s.license     = 'MIT'
 
   s.files = Dir['{app,config,db,lib}/**/*', 'MIT-LICENSE', 'Rakefile', 'README.rdoc']