From: "Hal E. Fulton" Date: 2002-08-31T15:11:15+09:00 Subject: Re: suggestions to the Ruby community [long] ----- Original Message ----- From: "Gavin Sinclair" To: "ruby-talk ML" Sent: Saturday, August 31, 2002 12:48 AM Subject: Re: suggestions to the Ruby community [long] > > > If people > > > here feel that the the overall online english ruby documentation does not > > > need improvement, great. > > > > No one said that! There's a huge need for improvement. But > > there's also a huge amount out there. > > It's reasonable then to point the question back at you! ;) If there's a huge > need for improvement, what's an example? Ha ha, touche'! The biggest doc deficiency in my mind is that some things are only in Japanese. I'd have to dig for an example. But surely you have run across things with all-Japanese docs? I guess SGmail is one example. It's an app, though, not a library. Some of the larger libraries are not wholly documented, I think. Tk, for instance; typically we go to other (non-Ruby) Tk references and then guess at the Ruby API. If you can't guess, you can grep the source or ask someone who knows. But I have found that the more likely I am to need/want something, the more likely it's already well documented in English. That probably indicates that I'm a "typical" or "general" user. Hal