Broken nested scoping

[ralphie02]

I believe scope nesting for the api request parameters are either not properly documented, or broken.
I am trying to do something similar to below:

get '/api/something" do
  parameter :person, "description", scope: :company
  parameter :name, "description", scope: [:company, :person]
end

for a parameter like this -> company[person][name]

but instead it creates something similar to this -> [:company, :person][name] [:company, :person][name]
and yes, there's 2 of the parameter names above this line

I could definitely be wrong and that this feature is already implemented, I'm just using it wrong. If I am, please let me know.

[oestrich]

What are you using to view the documentation? There is a good chance they just need to be updated to understand the new scopes.

[ralphie02]

I'm not using any specific viewer such as the ones mentioned in your documentation. I'm just viewing the simple HTML file generated by rake docs:generate

Is there a workaround for this?

[DevilsNightsix]

@ralphie02 You need to install Apitome from github master branch
add to your Gemfile

gem 'apitome', github: 'modeset/apitome'

[ralphie02]

@DevilsNightsix I was hoping I didn't have to install any doc viewer. Thanks for getting back to me!

[myabc]

I can confirm that this is still broken on master

response_field :id, 'Feedback ID', scope: [:comment, :feedback]

will render the following with both HtmlWriter and SlateWriter:

[:comment, :feedback][[:comment, :feedback][id]]

[DevilsNightsix]

Hello @myabc
I have made fix for this issue
If you want, you can use my fork of Apitome

[myabc]

@DevilsNightsix I'm not actually using Apitome, but thanks anyway!