Download Firefox: WindowsMac OS X
logo       
Google Custom Search
    AddThis Social Bookmark Button

Re: Ruby Docs with annotations and searching: msg#00018

Subject: 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 <conor.hunt+rails@xxxxxxxxx> 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





<Prev in Thread] Current Thread [Next in Thread>