Well, we've doc'd attributes elsewhere w/o using this form.  If it's supported by yard it's fine to use it but I want to make sure it looks fine first.  Have you looked at the rendered docs you get from this?  I wasn't able to get them to show up run I run yard locally.