From: Michal Suchanek <hramrach@...>
Date: 2009-10-07T06:15:21+09:00
Subject: Re: Ruby for the wrong reason

2009/10/6 James Edward Gray II <james@graysoftinc.com>:
> On Oct 6, 2009, at 1:59 PM, 7stud -- wrote:
>
>> 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.
>
> Well, they Ruby Core team does take patches.

It's not the same thing.

You can comment on the PHP documentation even if you don't know how to
make a patch and don't understand whatever format the docs are in.
Still people visiting the documentation site can read the comment.

It has its downsides, too. There are some meaningless comments or
multiple refinements of the same sample code.

Thanks

Michal