I'm using YARD on my Rails project and was wondering how I would go about documenting inherited/runtime methods on a Rails model? For instance documenting the existence of a first_name
attribute on a User
model.
views:
39answers:
1
+1
A:
You can't do that, IMHO.
The trouble is that those methods don't really "exist"; They are "created on the fly" via method_missing
hooks, the first time they are invoked, on runtime.
Other documentation generation systems have ways to declare "implicit" methods. For example NaturalDocs has a function keyword that allows you to create functions that only exist on the comments. I'm not familiar enough with YARD, but it seems it doesn't have a similar functionality.
Good luck!
egarcia
2010-05-19 07:43:50