Re: Ruby Docs with annotations and searching

> 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