HTML documentation displays multilevel scopes correctly

Author: oestrich

features/html_documentation.feature

@@ -29,6 +29,7 @@ Feature: Generate HTML documentation from test examples
         get "/greetings" do
           parameter :target, "The thing you want to greet"
           parameter :scoped, "This is a scoped variable", :scope => :scope
+          parameter :sub, "This is scoped", :scope => [:scope, :further]
 
           response_field :hello, "The greeted thing"
 
@@ -65,9 +66,10 @@ Feature: Generate HTML documentation from test examples
     When  I open the index
     And   I navigate to "Greeting your favorite gem"
     Then  I should see the following parameters:
-      | name          | description                 |
-      | target        | The thing you want to greet |
-      | scope[scoped] | This is a scoped variable   |
+      | name                | description                 |
+      | target              | The thing you want to greet |
+      | scope[scoped]       | This is a scoped variable   |
+      | scope[further][sub] | This is scoped              |
 
   Scenario: Examle HTML documentation should include the response fields
     When  I open the index

lib/rspec_api_documentation/views/markup_example.rb

@@ -28,6 +28,21 @@ def filename
         "#{basename}.#{extension}"
       end
 
+      def parameters
+        super.each do |parameter|
+          if parameter.has_key?(:scope)
+            scope = Array(parameter[:scope]).each_with_index.map do |scope, index|
+              if index == 0
+                scope
+              else
+                "[#{scope}]"
+              end
+            end.join
+            parameter[:scope] = scope
+          end
+        end
+      end
+
       def requests
         super.map do |hash|
           hash[:request_headers_text] = format_hash(hash[:request_headers])