From: Stefan Peters <stefan@...>
Date: 2009-10-07T07:22:11+09:00
Subject: Re: Ruby for the wrong reason



On 6 Okt., 23:15, Michal Suchanek <hramr...@centrum.cz> wrote:
> 2009/10/6 James Edward Gray II <ja...@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.


And lots of really bad/wrong/dangerous code (that is often c&p). I
dont think that comments are a good idea, but may be some kind of wiki
would be productive, because I also think, that the documentation
needs improvement.

  Stefan