On 12/07/06, Ralf Stephan <ralf@...748...> wrote:
[ snip ]
Finally, on Changelog, I'm personally against repetition of things that can be easily got from 'svn log'. But that's my 2 cents, ralf
+1
I KEEP six honest serving-men; (They taught me all I knew) Their names are What and Where and When And How and Where and Who.
There is a ragged but detailed note about maintaining a Changelog at http://wiki.inkscape.org/wiki/index.php/ChangeLog , which IIRC correctly, predates the switch to svn . Can you suggest any changes to this which would be widely accepted and be useful to new committers?
FWIW, I feel that repetition is always, always to be avoided (see DRY, exempli grati http://c2.com/cgi/wiki?DontRepeatYourself ), and my first suggestion is that the svn log should answer the What? question: What was changed; and the Changelog, the Why?: Why was this done.
I think that it is more important to get something relevant and accurate into the Changelog, preferably as short as is reasonably possible, rather than spend much time and divert unnecessary effort into getting that log just right
Ben