poorly formatted code   + no documentation or comments    = bad;
poorly formatted code   + bad documentation or comments   = bad;
[poorly formatted code  + good documentation or comments  = bad;]*
[well formatted code    + no documentation or comments    = GOOD;]*
well formatted code     + bad documentation or comments   = bad;
well formatted code     + good documentation or comments  = good;

where
well formatted code                  = minority;
poorly formatted code                = majority;
no OR bad documentation or comments  = majority;
*[good documentation or comments     = yeah right;]



-----Original Message-----
From: Jeffry Houser [mailto:[EMAIL PROTECTED]
Sent: Tuesday, May 10, 2005 7:42 AM
To: CF-Jobs-Talk
Subject: RE: What makes a programmer look low level


At 10:39 PM 5/9/2005, you wrote:
>Not all documentation is good; in fact, most is bad (in my experience.)

  In my experience, most is non-existent.  But, I've never had a problem
with documentation that is there.  And I still have a hard time imagining a
time where comments make it hard to follow the logic of code, no matter how
poorly written the documentation is.


--
Jeffry Houser, Web Developer, Writer, Songwriter, Recording Engineer
AIM: Reboog711  | Phone: 1-203-379-0773
--
My Company: <http://www.dot-com-it.com>
My Books: <http://www.instantcoldfusion.com>
My Recording Studio: <http://www.fcfstudios.com>
Connecticut Macromedia User Group: <http://www.ctmug.com>





~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~|
Logware (www.logware.us): a new and convenient web-based time tracking 
application. Start tracking and documenting hours spent on a project or with a 
client with Logware today. Try it for free with a 15 day trial account.
http://www.houseoffusion.com/banners/view.cfm?bannerid=67

Message: http://www.houseoffusion.com/lists.cfm/link=i:11:2589
Archives: http://www.houseoffusion.com/cf_lists/threads.cfm/11
Subscription: http://www.houseoffusion.com/lists.cfm/link=s:11
Unsubscribe: 
http://www.houseoffusion.com/cf_lists/unsubscribe.cfm?user=11502.10531.11
Donations & Support: http://www.houseoffusion.com/tiny.cfm/54

Reply via email to