From: David Douthitt Date: 2002-09-03T23:44:22+09:00 Subject: Re: suggestions to the Ruby community This is a MIME message. If you are reading this text, you may want to consider changing to a mail reader or gateway that understands how to properly handle MIME multipart messages. ----=_NextPart_ST_09_09_09_Tuesday_September_03_2002_25423 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Please don't use Wiki for docs.... at least not exclusively. To me Wiki's are overrated: * They can be ignored - questions come up, then don't get answered * Most require registration - my name, address, phone number, email address= are in enough places already - and I don't need to memorize another passwo= rd * Some get a number of "New Item" listings because people don't know how to= use them, and admins don't delete them * They require Internet access; suppose I'm not connected? To docs should be in man pages - not in info format (like GNU), not perldoc= format, not in a "convertable" format - not even in bundled html pages. E= very system you find will have man; most don't have lynx or info or rdtool,= etc. David Douthitt CUNA & Affiliates UNIX Systems Administrator ddouthitt@cuna.coop >>> yuchingtien@yahoo.com 8/31/02 8:37PM >>> 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. ----=_NextPart_ST_09_09_09_Tuesday_September_03_2002_25423 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable
Please don't use Wiki for docs.... at le= ast not=20 exclusively.
 
To me Wiki's are overrated:
 
* They can be ignored - questions come u= p, then=20 don't get answered
* Most require registration - my name, a= ddress,=20 phone number, email address are in enough places already - and I don't need= to=20 memorize another password
* Some get a number of "New Item" listin= gs=20 because people don't know how to use them, and admins don't delete=20 them
* They require Internet access; suppose = I'm not=20 connected?
 
To docs should be in man pages - not in = info=20 format (like GNU), not perldoc format, not in a "convertable" format - not = even=20 in bundled html pages.  Every system you find will have man; most don'= t=20 have lynx or info or rdtool, etc.
 
David Douthitt
CUNA & Affiliates<= BR>UNIX=20 Systems Administrator
ddouthitt@cuna.coop
 
 

>>> yuchingtien@yahoo.com 8= /31/02=20 8:37PM >>>
instead of everyone writing your own documentation, wouldnt a wiki
documentation better? everyone could just 'fix' what is w= rong,=20 add
exemples. japanese documentation could just be put there and=20 then
somebody else who knows japanese and english could translate it=20 later.

just a wierd idea.

----=_NextPart_ST_09_09_09_Tuesday_September_03_2002_25423--