From: John Wilger <johnwilger@...>
Date: 2005-01-25T21:46:30+09:00
Subject: Re: Ruby WikiDocs?

On Tue, 25 Jan 2005 10:03:40 +0900, James Britt
<jamesUNDERBARb@neurogami.com> wrote:
> John Wilger wrote:
> >
> > The real sweet spot, of course, would be to figure out how to automate
> > the backporting of the contributed documentation into the source
> > comments. Then it might actually happen. ;-)
> 
> Well, short of some AI that verifies the content for correctness, even
> per-class RSS feed might help the code/doc owners keep tabs when someone
> has commented.

I wasn't thinking quite _that_ automatic. More like: the
documentation---after being reviewed by someone with appropriate
authorization---could be added back into the source file in the
appropriate place with the click of a button. Basically just something
to keep the maintainer from having to retype the information. DRY.

-- 
Regards,
John Wilger

-----------
Alice came to a fork in the road. "Which road do I take?" she asked.
"Where do you want to go?" responded the Cheshire cat.
"I don't know," Alice answered.
"Then," said the cat, "it doesn't matter."
- Lewis Carrol, Alice in Wonderland