Re: Ruby Docs with annotations and searching

I had one idea to help with picking out good comments. Include a vote
up / vote down mechanism for comments. Then it is easier to pick out
comments that hit a certain threshold (either up or down) for
inclusion or exclusion.

--
Conor

On 5/17/06, Conor Hunt <[email protected]> wrote:
> > If you make it *too* easy to add a comment, you probably are
> > needlessly setting yourself up for a lot of de-spamming work. (It's
> > possible that the php and mysql folks do quite a bit of housekeeping
> > that we don't know about -- dunno.)
>
> Ok, yes I agree, especially as the site gets larger. Initially thoughI
> would argue that the barrier to commenting should be low to get
> momentum going.
>
> I really do like the way the PHP docs work, I don't know what they do
> in the background, but I have found incredible use from the comments,
> usually the comments are more useful than the official documentation!
> I have heard many times "why doesn't Ruby or Rails have documentation
> like PHP?"
>
> --
> Conor
>