On Tue, 19 Apr 2011 17:10:44 -0700, Darren New wrote:

> 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.

Code in and of itself doesn't include why, but one could argue (though 
I'd have to admit that it would be pointless to argue it with you or any 
other professional coder <g>) that that's what comments are for. ;)

Jim

Post a reply to this message