[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: changelog -vv (was Re: TortoiseSVN 1.3.1 released)

From: Jean-Marc van Leerdam <j.m.van.leerdam_at_gmail.com>
Date: 2006-01-29 14:30:46 CET

Steve,

Jean-Marc wrote:

> Do keep in mind that every program over 200 lines of code ;) will have
> > areas that are left alone for long periods of time, and even with one
> > developer, that piece of code will look like being written by someone
> > else. Without proper comments and version history available, maintenance
> > will become harder.
>
> Every programmer knows that. But every programmer also knows that good
> documentation and good comments are rare, because you either don't have
> the time or you forget the comments or you just think that it's
> 'obvious' or ...

And every *good* programmer knows he *has* to take the time to comment his
coding before he forgets the reasoning behind it. You *always* have the time
to comment your code (else you're rushing and that's a sure recipe for
disaster...).

Oh and please note that my remarks are intended as positive feedback; I
really admire your accomplishments with TSVN. I just think it is better to
fix two bugs in a proper documented way than fix five in the same timeframe
but without any comments.

Regards,

Jean-Marc

----------------
    ___
   // \\ @@ "De Chelonian Mobile"
  / \_/ \/._) TortoiseSVN
<\_/_\_/ / The coolest Interface to (Sub)Version Control
  /_/ \_\ Check out http://tortoisesvn.org
Received on Sun Jan 29 14:30:59 2006

This is an archived mail posted to the TortoiseSVN Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.