On 4/19/2011 17:06, Jim Henderson wrote:
> On Tue, 19 Apr 2011 16:48:35 -0700, Darren New wrote:
>
>>> Most OSS projects rely on code as the internal documentation.
>>
>> Code is not documentation. Anyone who thinks that code *is*
>> documentation on any project you feel the need to split into multiple
>> files is fooling themselves.
>
> Of course, that was pretty much what I said in the next sentence after
> what you quoted.

Even if everyone uses the same style, code isn't documentation. Even if only 
one person works on the code ever, code isn't documentation. Code is no more 
documentation than the steering wheel is your turn signals.

-- 
Darren New, San Diego CA, USA (PST)
   "Coding without comments is like
    driving without turn signals."

Post a reply to this message