Add support for documentation fields about grape-roar

[taybin]

Does this implement https://github.com/tim-vandecasteele/grape-swagger/issues/121?

[dblock]

@taybin Mostly, yes.

[danielkummer]

How can I use your code to document the swagger model - I can't really get it to work. The representer shows up in the grape documentation but both type and description are missing for the defined properties…

Update: Got it! The documentation method has to look like this (the documentation values are stored under attribute[:documentation]):

def documentation
    Hash[representable_attrs.map do |attribute|
        property_name = attribute[:as].evaluate nil, nil
        next if property_name == '_links'
        [property_name, {desc: attribute[:documentation][:desc], type: attribute[:documentation][:type]}]
    end.compact]
end

[dblock]

Would love it if someone turned this into production code :)

[sebweaver]

👍