> 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.

Thanks! I'll fix it