Go Back   Ultimate Web Site Drop Down Menu Forum > News and Information > General Web Trends and News
Register FAQ Members List Calendar Today's Posts

Reply
Thread Tools Display Modes
Unread 01-02-2010, 12:46 AM
sl4shd0t
Posts: n/a
  #1  
Default Myths About Code Comments

theodp writes "Jason Baker gives his take on the biggest misconceptions about code comments: 1) Comments are free ('When you update the code that the comment references, you usually have to update the comment as well'). 2) Comments make code more readable ('by far the most pervasive myth that I've encountered'). 3) You should comment every function, method, class, and module ('documenting something that needs no documentation is universally a bad idea'). 4) Code must always be 'self documenting' ('would you rather use a one-liner that requires a 3-line comment, or a 10-liner that requires no comments?')."pa href="http://developers.slashdot.org/story/10/01/01/226232/Myths-About-Code-Comments?from=rss"img src="http://developers.slashdot.org/slashdot-it.pl?from=rssamp;op=imageamp;style=h0amp;sid=10/01/01/226232"/a/ppa href="http://developers.slashdot.org/story/10/01/01/226232/Myths-About-Code-Comments?from=rss"Read more of this story/a at Slashdot./ppa href="http://feedads.g.doubleclick.net/~at/cz06J0pmTM7ZlTF3K65S5bqX7NM/0/da"img src="http://feedads.g.doubleclick.net/~at/cz06J0pmTM7ZlTF3K65S5bqX7NM/0/di" border="0" ismap="true"/img/abr/a href="http://feedads.g.doubleclick.net/~at/cz06J0pmTM7ZlTF3K65S5bqX7NM/1/da"img src="http://feedads.g.doubleclick.net/~at/cz06J0pmTM7ZlTF3K65S5bqX7NM/1/di" border="0" ismap="true"/img/a/pimg src="http://feeds.feedburner.com/~r/Slashdot/slashdotDevelopers/~4/Soi7AvYrayI" height="1" width="1"/

More...
Reply With Quote
Reply



Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

vB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Forum Jump


All times are GMT. The time now is 09:01 PM.


Powered by vBulletin® Version 3.0.1
Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.