Let YARD document the railties gem
Does this mean that Rails is switching to YARD as its API documentation? [/hopeful]
There are a couple of other options for Rails API. everyone wants good search stuff. Why shouldn't be YARD/other search friendly doc option ?
YARD can parse RDOC so it shouldn't be an issue.
Yeah, it doesn't understand some recent stuff we use but it works.
There's work being done with Hanna, and I believe static parsers are not the way to go for Rails. I prefer effort to be directed towards a new and more dynamic approach. I wrote about it a while back.