<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
<title></title>
</head>
<body bgcolor="#ffffff" text="#000000">
James Hawkins wrote:
<blockquote
cite="mid:22821af30810100041o6a87e97he3cec6fd946bf5e@mail.gmail.com"
type="cite">
<pre wrap="">On Fri, Oct 10, 2008 at 12:59 AM, Andrey Turkin <a class="moz-txt-link-rfc2396E" href="mailto:andrey.turkin@gmail.com"><andrey.turkin@gmail.com></a> wrote:
</pre>
<blockquote type="cite">
<pre wrap="">I can't see any value in commented out test or sort-of-meaningless code
comment.
</pre>
</blockquote>
<pre wrap=""><!---->
The tests serve as documentation of the API. In many cases, that
documentation is far superior to even msdn. Just because you know
that the implementation matches native doesn't mean that someone else
looking to work on the function knows that. He'll then waste time
figuring out what you already know. Ask yourself the opposite: what's
the harm in adding such documentation?
</pre>
</blockquote>
Non-misleading comment obviously cannot make any harm, and I can
imagine one (unlikely but not impossible)<br>
case when comment can be helpful so yes, I'll add both commented out
tests and sort-of-meaningless comment :)<br>
Hopefully nobody will object them.<br>
<br>
Regards,<br>
Andrey<br>
</body>
</html>