From: Rob Muhlestein Date: 2007-01-03T15:00:07+09:00 Subject: Re: Any projects need rdoc documentation help? Jay Bornhoft wrote: > As part of my effort to become increasingly more involved in the Ruby > community, I would like to volunteer my efforts towards any rdoc - > documentation requirements. This touches on two broader topics as well 1) a master prioritized TODO/Ruby list other than the 'project want ads' on RubyForge and 2) the state of the rdoc tool itself. A casual search of google doesn't reveal anything immediately. Seems like we could use some top priorites for the new year laid out and focus efforts on those, but probably a little oversimplified given the scope and number of Ruby projects out there to be done. Personally I'd like to see RAA/RubyGems registry a-la CPAN-ish stuff materialize more this year with focus on preventing filename clashes and namespace registration along with self-documenting code that produces web site documentation just by uploading it. I don't see that in RAA currently, but there is a lot going on out there. And then we could build on that with a community-based test grid and ratings, that would be cool. So far I find rdoc far from from the Perl POD or even JavaDoc I grew accustomed to. I realize there are other priorities. I do wonder why POD wasn't just stolen verbatum. It didn't seem 'broken' to me. People write entire books in POD. Please correct me, but I don't believe rdoc is to that level yet. Would be good to get it there. I'll have to dig up the rdoc 'project team' info, if any and take a look at todos for the rdoc tool itself.