From: Barry Sperling <barry@...>
Date: 2005-04-28T06:36:23+09:00
Subject: Re: Comments Are More Important Than Code



Dave Fayram wrote:


> 
> If you've got requirements that extend to that level of the software,
> I'd highly recommend that you get the code into a unit test framework
> and devise an automated test for each requiremnet.

The legacy code I've worked with comes mostly without comments and 
definitely without unit tests.  I suspect (without proof!) that the 
code-now mindset is no more inclined to write tests first than it is to 
write documentation.  Yes, unit tests would help a lot.

> 
> 
> I suspect that we're having a debate of defintion. When I think good
> documentation, I think of what Rails does. That's what I'm trying,
> perhaps unclearly, to express.
> 
I haven't seen the Rails code.  The last I saw (a while ago) it wouldn't 
do Oracle on Windows so I left it alone.  Maybe it does now.
	As I said, we'll have to agree to disagree.  Good luck,
	Barry