I went and looked up how to do these sorts of docs and I found that on the yard site... http://rubydoc.info/gems/yard/file/docs/Tags.md#attribute