On Dec 4, 2012, at 12:57 PM, Sven Van Caekenberghe wrote:
> But I think we do agree ;-)
>
> What makes me value tests a bit above documentation (but not so much that I
> am saying that documentation is not important), are two things:
>
> - tests are machine enforceable/controllable
> - you can find them exactly using senders or references
sure I still want somebody to help with
<testForDocumentation> idea.
so that some tests are added to the documentation of package
Stef
>
> On 04 Dec 2012, at 12:49, Stéphane Ducasse <[email protected]> wrote:
>
>> Comments are ***REEEAALLLLY*** important because they help a guy reading the
>> code to say yes you are smart and you got it right
>> I will explain you why.
>>
>> Even writing comment in test is cool.
>>
>> Stef
>>
>>> Well written:
>>>
>>> http://kennethreitz.org/open-source-and-constraints.html
>>>
>>> I also find that writing documentation (minimal method/class comments or
>>> longer standalone documents) improves coding, because you take another
>>> perspective. I wouldn't value it above tests though.
>>>
>>> Sven
>>>
>>> --
>>> Sven Van Caekenberghe
>>> http://stfx.eu
>>> Smalltalk is the Red Pill
>>>
>>
>
>
