<?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"
	>
<channel>
	<title>Comments on: Between TDD and Java code comments</title>
	<atom:link href="http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/feed/" rel="self" type="application/rss+xml" />
	<link>http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/</link>
	<description>Unfortunate day dreamer</description>
	<pubDate>Wed, 07 Jan 2009 10:33:07 +0000</pubDate>
	<generator>http://wordpress.org/?v=2.5</generator>
		<item>
		<title>By: xiaoming</title>
		<link>http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/#comment-9</link>
		<dc:creator>xiaoming</dc:creator>
		<pubDate>Thu, 04 Oct 2007 00:54:24 +0000</pubDate>
		<guid isPermaLink="false">http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/#comment-9</guid>
		<description>Many thanks for your comments, Lingling!

When we do agile, the last thing that we want to do is "documentation". We do not have much design documents except they are necessary. For software architecture, we use diagrams and photos that were taken during the architecture discussion. We do have documents like "user guide" or "read me". However, as the application that we developed have rich usability, and well designed so sometimes even documentation is not necessary.  It vary case by case. Roughly speaking, compared to Waterfall model, agile software development has much less documents. 

For your questions, I'd like to give you an real example for explanation, please have a look at the post context if you still have questions please feel free to ask.</description>
		<content:encoded><![CDATA[<p>Many thanks for your comments, Lingling!</p>
<p>When we do agile, the last thing that we want to do is &#8220;documentation&#8221;. We do not have much design documents except they are necessary. For software architecture, we use diagrams and photos that were taken during the architecture discussion. We do have documents like &#8220;user guide&#8221; or &#8220;read me&#8221;. However, as the application that we developed have rich usability, and well designed so sometimes even documentation is not necessary.  It vary case by case. Roughly speaking, compared to Waterfall model, agile software development has much less documents. </p>
<p>For your questions, I&#8217;d like to give you an real example for explanation, please have a look at the post context if you still have questions please feel free to ask.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: lingling</title>
		<link>http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/#comment-8</link>
		<dc:creator>lingling</dc:creator>
		<pubDate>Wed, 03 Oct 2007 18:54:11 +0000</pubDate>
		<guid isPermaLink="false">http://ossme.com/2007/10/02/between-tdd-and-java-code-comments/#comment-8</guid>
		<description>About the function: one function (in Java, one method) should only do one thing and do it well.  Otherwise, break it down. About the comments, I believe documentation comments are very important and we must have them. Inline comments can be eliminated by high-quality code.

Questions:  I understand that in TDD you write the test cases before you write the code. In your test, you run totally 4 test cases.
1. Is each test case designed to test one of the three acceptance criteria?
2. How do you define the test is "failed"? e.g. If the result data is not "exactly match" the expected data? or the test doesn't run properly?
3. Why did you "pass" this test with only one test case for each requirement?

Thanks.</description>
		<content:encoded><![CDATA[<p>About the function: one function (in Java, one method) should only do one thing and do it well.  Otherwise, break it down. About the comments, I believe documentation comments are very important and we must have them. Inline comments can be eliminated by high-quality code.</p>
<p>Questions:  I understand that in TDD you write the test cases before you write the code. In your test, you run totally 4 test cases.<br />
1. Is each test case designed to test one of the three acceptance criteria?<br />
2. How do you define the test is &#8220;failed&#8221;? e.g. If the result data is not &#8220;exactly match&#8221; the expected data? or the test doesn&#8217;t run properly?<br />
3. Why did you &#8220;pass&#8221; this test with only one test case for each requirement?</p>
<p>Thanks.</p>
]]></content:encoded>
	</item>
</channel>
</rss>
