From: 7stud -- <bbxx789_05ss@...>
Date: 2009-10-07T03:59:56+09:00
Subject: Re: Ruby for the wrong reason

James Edward Gray II wrote:
> On Oct 6, 2009, at 1:33 PM, 7stud -- wrote:
> 
>> That last one is a real doozy--and quite typical of ruby Standard
>> Library documentation.
> 
> You've been shown the format option from the documentation.  I'm not
> sure how much more proof you require.
> 

I already knew the format specifiers were described in the Time class. 
The question is whether someone new to ruby could figure out how to 
format Date objects.  I think not.  The reason: ruby has poor 
documentation.

>
> You've obviously gone into the source to find them once, to bad you
> didn't create a documentation patch while you were there.
> 
> James Edward Gray II

I have suggested a better solution in the past, and I'll suggest it 
again: open up the ruby docs to user comments like php does.  If the 
ruby community wants to continue with the worst docs I've ever seen, 
then so be it.

-- 
Posted via http://www.ruby-forum.com/.