This isn't how an option is documented in YARD. `@param` is for positional arguments. There should be one for `options` and then you can use the following for the individual options: http://rubydoc.info/docs/yard/file/docs/Tags.md#option