From: Michael Granger Date: 2007-12-18T08:11:11+09:00 Subject: Re: Language Popularity - PHP vs Ruby? Sorry to respond to such an old thread, but I didn't see this addressed at all. On Nov 6, 2007, at 12:25 PM, bwv549 wrote: > PHP isn't as consistent or beautiful as ruby, but it hardly matters > when you have online documentation like this: > > http://www.php.net/manual/en/ Does this mean you don't know about http://ruby-doc.org/ or don't consider it to be "excellent, up-to-date, comprehensive online documentation"? As someone who started using Ruby when the only documentation was in Japanese, I find complaints about Ruby's current supposed lack of documentation (online or otherwise) to be surprising. The online docs aren't perfect, of course, but that's true of any documentation for any project which is still in active development. I personally find that the online docs cover 90% of what I need, and between referencing the source (which is where beauty very much DOES count) and the helpfulness of the community, the other 10% is more than covered. > We (the ruby community) really should have excellent, up-to-date, > comprehensive online documentation. Considering its online > documentation, it is amazing that ruby is as popular as it is. What about Ruby's online documentation do you find lacking? > Are there any projects out there attempting to create good, online > documentation for ruby? Yes, (since sometime in 2002): http://ruby-doc.org/stdlib/status.html is a good place to start if you're wanting to contribute your effort to the existing docs. And you wouldn't have voiced your criticism of the current docs if you weren't, right? ;) -- Michael Granger Rubymage, Architect, Believer The FaerieMUD Consortium