<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
		>
<channel>
	<title>Comments on: 13 Tips to Comment Your Code</title>
	<atom:link href="http://www.devtopics.com/13-tips-to-comment-your-code/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.devtopics.com/13-tips-to-comment-your-code/</link>
	<description>Software Development Topics</description>
	<lastBuildDate>Wed, 17 Mar 2010 04:35:02 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.2</generator>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
		<item>
		<title>By: Anders Lindén</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-78965</link>
		<dc:creator>Anders Lindén</dc:creator>
		<pubDate>Fri, 22 Jan 2010 14:10:24 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-78965</guid>
		<description>Mostly, the urge to write a comment serves as an indicator that your code needs to be improved.

How the code in tip 2 could be made comment free:
check_data_records();
perform_transactions();

And the code in tip 3:
const MAX_NUMBER_OF_PACKETS = 10;
const TCP_BITMASK = 0x1F;</description>
		<content:encoded><![CDATA[<p>Mostly, the urge to write a comment serves as an indicator that your code needs to be improved.</p>
<p>How the code in tip 2 could be made comment free:<br />
check_data_records();<br />
perform_transactions();</p>
<p>And the code in tip 3:<br />
const MAX_NUMBER_OF_PACKETS = 10;<br />
const TCP_BITMASK = 0&#215;1F;</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Mark</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-70759</link>
		<dc:creator>Mark</dc:creator>
		<pubDate>Thu, 17 Dec 2009 07:57:47 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-70759</guid>
		<description>In response to all those who say things like ; 

&quot;Or, better yet, don’t do comments and make the code speak for itself&quot;

What a load of garbage. !!   For professional companies and programmers, comments are a must. Code needs to be maintained and the original developer is not going to be there forever, and if they are, they probably won&#039;t remember what the heck they wrote a function or class for anyway two years down the track. 

As an employer, or company CIO, or owner of a piece of code that needs to be updated / maintained, the last thing you want is to have a new developer sitting crawling through code unnecessarily trying to read and interpret someone else’s style and determine what a piece of code is doing, when all they needed to do was read the Brief, and the Date it was done, and any Updates that were added and Why. 

Laziness is no excuse to not be professional and think about those coming along behind you that may need to review what you have done. A simple few lines of comment could save a great deal of time, money, and grief.</description>
		<content:encoded><![CDATA[<p>In response to all those who say things like ; </p>
<p>&#8220;Or, better yet, don’t do comments and make the code speak for itself&#8221;</p>
<p>What a load of garbage. !!   For professional companies and programmers, comments are a must. Code needs to be maintained and the original developer is not going to be there forever, and if they are, they probably won&#8217;t remember what the heck they wrote a function or class for anyway two years down the track. </p>
<p>As an employer, or company CIO, or owner of a piece of code that needs to be updated / maintained, the last thing you want is to have a new developer sitting crawling through code unnecessarily trying to read and interpret someone else’s style and determine what a piece of code is doing, when all they needed to do was read the Brief, and the Date it was done, and any Updates that were added and Why. </p>
<p>Laziness is no excuse to not be professional and think about those coming along behind you that may need to review what you have done. A simple few lines of comment could save a great deal of time, money, and grief.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Indentation, comments and readability. &#124; Coil Plane Networks</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-69010</link>
		<dc:creator>Indentation, comments and readability. &#124; Coil Plane Networks</dc:creator>
		<pubDate>Tue, 08 Dec 2009 17:15:51 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-69010</guid>
		<description>[...] 13-tips-to-comment-your-code [...]</description>
		<content:encoded><![CDATA[<p>[...] 13-tips-to-comment-your-code [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: 網站製作學習誌 &#187; [Web] 連結分享</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-66339</link>
		<dc:creator>網站製作學習誌 &#187; [Web] 連結分享</dc:creator>
		<pubDate>Wed, 25 Nov 2009 02:39:39 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-66339</guid>
		<description>[...] 13 Tips to Comment Your Code [...]</description>
		<content:encoded><![CDATA[<p>[...] 13 Tips to Comment Your Code [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Pico RG</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-63127</link>
		<dc:creator>Pico RG</dc:creator>
		<pubDate>Fri, 06 Nov 2009 01:57:01 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-63127</guid>
		<description>I don&#039;t like scripts that are commenting much since I found out that they are too slow</description>
		<content:encoded><![CDATA[<p>I don&#8217;t like scripts that are commenting much since I found out that they are too slow</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: reviews</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-57140</link>
		<dc:creator>reviews</dc:creator>
		<pubDate>Fri, 02 Oct 2009 09:14:21 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-57140</guid>
		<description>Lovely. Made my day (which is saying something)</description>
		<content:encoded><![CDATA[<p>Lovely. Made my day (which is saying something)</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: The Real Reason to Comment Your Code</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-56884</link>
		<dc:creator>The Real Reason to Comment Your Code</dc:creator>
		<pubDate>Wed, 30 Sep 2009 17:11:50 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-56884</guid>
		<description>[...] the code is trying to do, so therefore comments should describe WHY you are doing it.&#160; Also, a good article by my friend José M. Aguilar provides 13 tips on how to comment your [...]</description>
		<content:encoded><![CDATA[<p>[...] the code is trying to do, so therefore comments should describe WHY you are doing it.&#160; Also, a good article by my friend José M. Aguilar provides 13 tips on how to comment your [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Deranged Carrot</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-47802</link>
		<dc:creator>Deranged Carrot</dc:creator>
		<pubDate>Mon, 27 Jul 2009 20:31:14 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-47802</guid>
		<description>Good post =D  

Definitely a Coding 101 that most people overlook.  Even I&#039;m guilty of it... it took my first big project to learn how blowing off documentation is a recipe for disaster...and block-box coding.

Comments before code saves me hours if not days.  Because after I finish one section sometimes I&#039;m so into the previous section that I forget what the intentions of the previous codeblock where =P</description>
		<content:encoded><![CDATA[<p>Good post =D  </p>
<p>Definitely a Coding 101 that most people overlook.  Even I&#8217;m guilty of it&#8230; it took my first big project to learn how blowing off documentation is a recipe for disaster&#8230;and block-box coding.</p>
<p>Comments before code saves me hours if not days.  Because after I finish one section sometimes I&#8217;m so into the previous section that I forget what the intentions of the previous codeblock where =P</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: 13 tips to comment your code &#171; All Information Technology</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-43581</link>
		<dc:creator>13 tips to comment your code &#171; All Information Technology</dc:creator>
		<pubDate>Sun, 14 Jun 2009 13:06:26 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-43581</guid>
		<description>[...] : Click here  Possibly related posts: (automatically generated)If the code and the comments disagree, then both [...]</description>
		<content:encoded><![CDATA[<p>[...] : Click here  Possibly related posts: (automatically generated)If the code and the comments disagree, then both [...]</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: 网页设计注释技巧13个 &#124; 网站设计&#38;网站设计公司</title>
		<link>http://www.devtopics.com/13-tips-to-comment-your-code/comment-page-1/#comment-34356</link>
		<dc:creator>网页设计注释技巧13个 &#124; 网站设计&#38;网站设计公司</dc:creator>
		<pubDate>Fri, 27 Feb 2009 14:59:18 +0000</pubDate>
		<guid isPermaLink="false">http://www.mini-tools.com/at2/devtop/wordpress/13-tips-to-comment-your-code/#comment-34356</guid>
		<description>[...] Martin在获得Aguilar先生的授权下，对该文章进行翻译、修改，并且在DevTopics上发布。 [...]</description>
		<content:encoded><![CDATA[<p>[...] Martin在获得Aguilar先生的授权下，对该文章进行翻译、修改，并且在DevTopics上发布。 [...]</p>
]]></content:encoded>
	</item>
</channel>
</rss>
