From: Massimiliano Mirra <list@...>
Date: 2002-09-01T21:28:56+09:00
Subject: Re: suggestions to the Ruby community

On Sun, Sep 01, 2002 at 11:20:51AM +0900, Matt Gushee wrote:
> On Sun, Sep 01, 2002 at 10:37:52AM +0900, yct wrote:
> > instead of everyone writing your own documentation, wouldnt a wiki
> > documentation better? everyone could just 'fix' what is wrong, add
> > exemples. japanese documentation could just be put there and then
> > somebody else who knows japanese and english could translate it later.
> > 
> > just a wierd idea.
> 
> I agree with the closing sentence ;-) Wikis are cool, but as the primary
> form of Ruby documentation? Please, no!
> 
> Wikis appeal to the geek world, and a subset of it at that. I believe
> the original poster's main argument was that Ruby needs better
> documentation to be accepted *by businesses*. You show me a suit who can
> get his head around a Wiki, and I'll show you my pet Triceratops.

I believe even a suit can get his head aroun www.emacswiki.org.  So
get your Triceratops ready. :-)

That said, I too agree that using a wiki as a primary mean would be
pushing things a bit too much.  But for cookbook style documentation,
I find the above mentioned site pretty much shows it can be done and
it can be done well.

Massimiliano