DB field documentation suggestions wanted

Rails
1

Where do folks generally document their database attributes?

They appear as attributes (or methods) to the model. Is there a way to
add pseudo methods so that rdoc picks them up along with their
documentation but they are not really defined in the ruby code? Or do
people just add comments for the model class and document the fields
there?

Also, as I recall, somewhere there is a tool that will run and pull the
fields from the DB (or the migration?) and put them as comments in the
model. Does that tool still exist?

Thank you,
Perry

2

I think this is the tool you mean:

http://agilewebdevelopment.com/plugins/annotate_models

3

Roy P. wrote:

I think this is the tool you mean:

http://agilewebdevelopment.com/plugins/annotate_models

Also take a look at HoboFields, which sort of does the same thing in
reverse. I’ve been experimenting with it and finding it pretty useful.
Basically, you define the fields right in the model file, and it writes
migrations for you.

Best,

Marnen Laibow-Koser
http://www.marnen.org
[email protected]