From: Tom Cloyd <tomcloyd@...>
Date: 2009-06-23T09:51:28+09:00
Subject: Re: ruby suggestion: officially sanctioned tutorials/howto's

James Gray wrote:
> 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
>
>
I'm liking this thread a LOT. However, as a perpetual Ruby amateur (in 
both senses - non-professional, and lover), I would like to see the wiki 
notion preserved.

If the only author for this material is the programmer(s), that's 
needlessly limiting. Some never have time to write up such tutorials, 
AND community people have some very good ideas which they would do well 
to contribute to the tutorial, over and above the thoughts of the 
code-originator. I'd want both sources of input, for the benefit of 
people like me (who need all the help they can find).

I sure hope this fine idea sees the light of day.

Tom

-- 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Tom Cloyd, MS MA, LMHC - Private practice Psychotherapist
Bellingham, Washington, U.S.A: (360) 920-1226
<< tc@tomcloyd.com >> (email)
<< TomCloyd.com >> (website) 
<< sleightmind.wordpress.com >> (mental health weblog)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~