That doesn't render right at all:

![screen shot 2014-03-18 at 9 47 51 am](https://f.cloud.github.com/assets/49391/2450616/1b0f131c-aebd-11e3-8e1c-9121e46fae76.png)

The `@!attribute` directive is for attributes that are not defined using `attr_reader`, `attr_writer` or `attr_accessor` (e.g. via some custom class macro that YARD doesn't know creates an attribute).

> BTW, according to the docs @attr is deprecated...

Huh?  I'm not using `@attr`.