<<-MESSAGE.gsub(/^ +\|\s/, '').strip
| Compare:
| ```ruby
| def generate_1(document, options = {})
| format = options.delete(:format)
| limit = options.delete(:limit) || 20
| # ...
| [format, limit, options]
| end
| options = { format: 'csv', limit: 5, useless_arg: :value }
| generate_1(1, options) #=> ["csv", 5, {:useless_arg=>:value}]
| generate_1(1, format: 'csv', limit: 5, useless_arg: :value) #=> ["csv", 5, {:useless_arg=>:value}]
| # vs
| def generate_2(document, format:, limit: 20, **options)
| # ...
| [format, limit, options]
| end
| options = { format: 'csv', limit: 5, useless_arg: :value }
| generate_2(1, **options) #=> ["csv", 5, {:useless_arg=>:value}]
| generate_2(1, format: 'csv', limit: 5, useless_arg: :value) #=> ["csv", 5, {:useless_arg=>:value}]
| ```
MESSAGE