Nested Documentation

When using Grape, Grape Entity and Grape Swagger and I have an entity with a nested object. Should we have the ability to provide nested documentation if that object has a nested object inside?

Example.

class User < Grape::Entity
  expose :id,        documentation: { type: 'Integer', desc: 'Id' }
  expose :firstname, documentation: { type: 'String', desc: 'First Name' }
  expose :lastname,  documentation: { type: 'String', desc: 'Last Name' }
  expose :username,  documentation: { type: 'String', desc: 'Username' }
  expose :email,     documentation: { type: 'String', desc: 'Email' }

  expose :location, using: API::Entities::Location, as: :location 

But when I call

API::Entities::User.documentation

it doesn't include my location inside the documentation hash.

Start with API::Entities::User.documentation and the exposed API::Entities::Location relation, then trace how Grape::Entity builds the documentation hash for nested objects. Done means User.documentation includes the nested location documentation, including an object nested inside that location.