From: Daniel Carrera <dcarrera@...>
Date: 2003-12-17T04:31:33+09:00
Subject: Re: Newbie questions

> We could always make our own version of the program.
> 
> Personally I'd call it "rman" or some such.

rman sounds good.


> If I were designing it, this is how I would approach it:
[snip]
> 
> That's a moderately tall order.
> 
> The real tall order, though, is producing the content itself (and
> controlling the quality and accuracy).


Indeed.  I think that the main thing Perl has is just plain age.
After being very popular for a long time, there has been enough 
opportunity for the formation of a good system with good documentation.


If nothing else, we, as a Ruby community, should agree that these are 
desirable goals.  That is, that we want more than a list of module 
names, but we want something like the "rman" you just described.

It'll take time to make something like this, but if we agree that this 
is what we want, then newly-produced documentation can be designed
accordingly.

> I'd be willing to contribute now and then.
> 

I'd be willing to contribute a few beginner tutorials.

I think that we should thrive towards a single repository of 
documentation like "rman".

We can start with some basic things like:


rman ruby  ->  Overall description of ruby and a list of other 
               rman pages.  See "man perl".

rman rubytut -> Intro to ruby

...

We can look at "man perl" for ideas.

Cheers,
-- 
Daniel Carrera | "Software is like sex.  It's better when it's free".
PhD student.   | 
Math Dept. UMD |     -- Linus Torvalds