I know this is pedantic, but can it be `query_options`?

Separately, in yard you can specify the options available in a hash with `@option` - check out http://rubydoc.info/gems/yard/file/docs/Tags.md#option.