Options should be documented [as described here](http://rubydoc.info/gems/yard/file/docs/Tags.md#option).