[Kolab-devel] Re: What is the policy for the ChangeLog file?

[Richard Bos]

Op dinsdag 6 december 2005 16:33, schreef Bernhard Reiter:
> > I'd really appreciate having a good changelog.
>
> It would not be bad to have one,
> however,
> most of the information can be found over CVS mechanisms quite easily.
> So far we do not have a Changelog policy.

It would be ChangeLog (not changelog neither Changelog) as it refers to the 
ChangeLog file, e.g.: 
http://kolab.org/cgi-bin/viewcvs-kolab.cgi/server/kolabd/kolabd/ChangeLog?rev=1.5&content-type=text/vnd.viewcvs-markup

> The question then also is: On how many levels should be keep one.

Only 1 (file).  That is the good thing about it, 1 file describing 
(summarizing) all changes.  Especially which files, variables, functions etc 
changed.  Well see example referred to above.  With that information it is 
easy to track what changed in last month.  Do you know what happened between 
Juli 2004 and november 2005 (if you're not interested at all, than no 
ChangeLog is needed).  

> The next point of thinking about a changelog policy would be
> when we switch to a different version control system
> (I guess it will be SVN).

It is not dependend on cvs, svn, or bitkeeper, etc.  It is up to the group to 
decide how to deal with it.  I like the ChangeLog it forces me to look over 
the changes once more, and it is good for others to quickly see what has 
changed.

-- 
Richard Bos
Without a home the journey is endless