Since these methods are DSL magic in Rails, the documentation generator (RDoc) doesn’t know about them. So unless you’re reading the code, you won’t know they even exist!
I’ve started a WIP to teach it about them, first with mattr_*
, but happy to hand this off and help anyone eager to see this through:
Once we’re able to parse all of those variations into the RDoc context, we simply need to read them and display them in the SDoc template like we do for other attributes:
That is assuming we’re fine just having a separate section dedicated to each type of attribute. I think this is a good start, and certainly better than not having them at all!
Feel free to reach out if you’re interested!