Re: Ruby Docs with annotations and searching

John Gabriele wrote:
> On 5/18/06, mathew <meta@xxxxxxxxx> wrote:
> > John Gabriele wrote:
> > > [snip]
> > >
> > > Doing what you describe is gruelling work. I would guess it generally
> > > involves poring over a thread that you may not be intently interested
> > > in, boiling it down, and then finding the .rb source file it belongs
> > > in, editing it into something good, and then handling the commit
> > > yourself. You're pulling the whole load! Asking people to do all that
> > > is a tough proposition.
> >
> > Right, and this proposed web site has exactly the same problem.
> I'd agree if it were just one person adding the comments and then
> doing the commit. But I think it's a reasonable guess that you might
> have comments from a number of people making up the final committed
> docs in the end.
But that's not where the bottleneck is. There's already tons of comment 
out there, the problem is finding people willing to turn it into 
checked-in documentation.
mathew