Re: Some more? (was: Re: My Best Ruby Documentation Suggestion)

On Aug 22, 2005, at 3:55 AM, Sy wrote:
> I would disagree in that comments still have to be integrated into an
> article, creating an overhead as compared to entirely user-editable
> material.

imo this overhead is a needed evil in order to keep documents in a  
unified style.

> But for something like library docs (as opposed to
> user-documentation).. yeah, I see how basic commenting would be the
> obvious step to take.

the utility of the community comments on php.net alone should be  
enough evidence of this :)

Alex