Currently, grape-swagger-entity assumes that required is false unless it's explicitly set with documentation: { required: true }:

grape-entity always renders fields by default. Conditional exposure is an opt-in feature: https://github.com/ruby-grape/grape-entity?tab=readme-ov-file#conditional-exposure

I think it would make more sense to change the behavior as follows:

• if options.dig(:documentation, :required) is set, use that
• otherwise, if options[:if] is set, set required to false
• otherwise, set required to true

What do you think?