From: Dick Davies <rasputnik@...>
Date: 2005-01-20T23:12:58+09:00
Subject: Re: Best ways to accelerate Ruby's popularity

* James F.  Hranicky <jfh@cise.ufl.edu> [0108 13:08]:
> > 3. last but not least, online docs on Ruby's primary website (not 
> > 3rd-party websites) that is similar to those provided by PostgreSQL and 
> > Python. Maybe we can volunteer to create 'official' ruby docs to be 
> > hosted on ruby's primary website.  Preferably using a popular 
> > documentation format that does not use frames like these:
> 
> I know I'm getting into this late, but how about if each module came
> with it's own ri documentation, similar to perl's perldoc. 
> 
> I know being able to do this
> 
> 	ri Socket
> 	ri OpenSSL
> 	ri Net::SSH
> 
> would be great.
> 
> I think this, coupled with an up-to-date syntax manual would be a
> huge boost to Ruby acceptance. 
> 
> Anyone agree?

Damn right. I really miss this, and since I've started picking up my
ruby coding it's become more of a pain. 

I'd also venture that there's less impetus on a developer to document his 
code if it's hard to get at the docs - 'write only' data smells like red tape.

doc crew: Is there a reason why it's difficult, or is it just low priority?

-- 
'Oh how awful. Did he at least die peacefully? ....To shreds you say, tsk tsk tsk.
Well, how's his wife holding up? ....To shreds, you say...'
		-- Prof. Farnsworth
Rasputin :: Jack of All Trades - Master of Nuns