Re: Ruby Docs with annotations and searching
mathew <[email protected]>
| Newsgroups | gmane.comp.lang.ruby.documentation |
|---|---|
| Message-ID | <[email protected]> |
John Gabriele wrote: > On 5/18/06, mathew <[email protected]> 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