On Jun 22, 2009, at 7:10 AM, Roger Pack wrote:

> I would like to suggest a more "officially sanctioned" Ruby
> tutorial/howto to try to help fill that void.

I think this is a very good idea.

I was just thinking the other day about how I really like that perldoc  
can do more than just look up method definitions.  For example, it can  
search Perl's FAQ for you.  I realize that's not exactly what you are  
suggesting here, but I found it useful in a similar way during my time  
in their camp.

> Another option might be to add very long, tutorial style rdoc comments
> to classes.

We could create a tutorials folder in the main distribution, write  
RDoc marked-up tutorials in there, and add those files to the  
documentation build.  I'm not sure that's the best possible strategy,  
but it is one idea.

James Edward Gray II