@JonRowe I think you are using the syntax in a wrong order here:

it needs to be:

```@attr``` ```[Types]``` ```attribute_name``` ```a full description of the attribute```
not:
```@attr``` ```attribute_name``` ```[Types]``` ```a full description of the attribute```

see:
https://github.com/lsegal/yard/wiki/Tags#wiki-list-of-available-tags