Some documentation flags

Author: kzaitsev

.rubocop_todo.yml

@@ -1,20 +1,20 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2016-05-07 20:24:20 +0300 using RuboCop version 0.39.0.
+# on 2016-05-08 06:18:31 +0300 using RuboCop version 0.39.0.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
 # versions of RuboCop, may require this file to be generated again.
 
-# Offense count: 1
+# Offense count: 2
 Metrics/AbcSize:
-  Max: 29
+  Max: 30
 
 # Offense count: 2
 Metrics/CyclomaticComplexity:
-  Max: 10
+  Max: 11
 
-# Offense count: 69
+# Offense count: 65
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes.
 # URISchemes: http, https
 Metrics/LineLength:
@@ -27,7 +27,7 @@ Metrics/MethodLength:
 
 # Offense count: 2
 Metrics/PerceivedComplexity:
-  Max: 13
+  Max: 14
 
 # Offense count: 2
 Style/Documentation:

lib/grape-swagger/representable/parser.rb

@@ -41,7 +41,7 @@ def parse_representer_property(property)
 
           memo[:enum] = documentation[:values] if documentation[:values].is_a?(Array)
 
-          if is_a_collection
+          if is_a_collection || documentation[:is_array]
             memo = {
               type: :array,
               items: memo
@@ -56,7 +56,7 @@ def representer_mapping(representer, documentation, is_a_collection = false, is_
         if nested.nil? && is_a_decorator
           name = endpoint.send(:expose_params_from_model, representer)
 
-          if is_a_collection
+          if is_a_collection || documentation[:is_array]
             {
               type: :array,
               items: {
@@ -79,9 +79,9 @@ def representer_mapping(representer, documentation, is_a_collection = false, is_
               type: :array,
               items: {
                 type: :object,
-                properties: attributes,
-                description: documentation[:desc] || ''
-              }
+                properties: attributes
+              },
+              description: documentation[:desc] || ''
             }
           else
             {

spec/grape-swagger/representers/response_inline_representer_spec.rb

@@ -135,9 +135,9 @@ def app
             'properties' => {
               'name' => { 'description' => 'Name', 'type' => 'string' },
               'color' => { 'description' => 'Tag color.', 'type' => 'string' }
-            },
-            'description' => 'Tags.'
-          }
+            }
+          },
+          'description' => 'Tags.'
         }
       }
     )