I’m using YARD to generate docs for my rails app with makrdown as the script parser. Most of the documentation features just work great right out of the box. However, I’d also like to document the model attributes to one, record the list of available attributes on a model and two, to describe their semantic meaning.
I wasn’t able to find any special support for this in YARD and I’m basically left with simply listing out the attributes in the class comments. Is there a way to document the dynamically generated model attributes so that they appear in the documentation like standard attributes/methods?
P.S. I’ve used the annodate-models gem to generate a basic schema dump at the top of the class listing but that’s not really what I want.
After quite a while searching around, I punted and manually added the documentation for the attributes to the model files. This is certainly not ideal, but hopefully the model structure won’t change a whole lot.
I created a .yardopts file for the project and used the yard command-line options to create two new tags for marking these up:
These provide me with specific tags for marking up the attributes and associations; they will show up grouped under the “Attributes” and “Associations” headings in the documentation. I can add this:
Maybe someone will write a plugin for YARD that will parse out the annotate-models output.