From: Robert Dober <robert.dober@...>
Date: 2009-06-23T08:20:43+09:00
Subject: Re: ruby suggestion: officially sanctioned tutorials/howto's

On Mon, Jun 22, 2009 at 6:50 PM, Joel VanderWerf<vjoel@path.berkeley.edu> wrote:
> James Gray wrote:
>>
>> On Jun 22, 2009, at 7:10 AM, Roger Pack wrote:
>>>

> To expand on James's proposal a bit... what about defining a module called,
> for example, Socket::Tutorial, and putting the material in the comment block
> of that module, for rdoc to find? Then:
>
>  `ri Tutorial` ==> list of tutorials(*)
>
>  `ri Socket::Tutorial` ==> the socket tutorial
>
>  `ri Socket::Tutorial.open` ==> tutorial on Socket.open.
>
> (*) actually, I'm not sure current ri performs a search for x::Tutorial, but
> why shouldn't it?
>
> --
>      vjoel : Joel VanderWerf : path berkeley edu : 510 665 3407
Honestly that sounds brilliant. I am just a little bit confused about
the x::Tutorial, should that not be Tutorial::X
for X in { Array, Module, Class, Exception, Enumerator, You::Name::It } ?

And Tutorial would be a module in the standard lib?
Cheers
Robert


-- 
Toutes les grandes personnes ont d’abord été des enfants, mais peu
d’entre elles s’en souviennent.

All adults have been children first, but not many remember.

[Antoine de Saint-Exupéry]