[En-Nut-Discussion] Changelog for releases

Ole Reinhardt ole.reinhardt at embedded-it.de
Wed Aug 22 22:59:12 CEST 2012


Hi Harald,

> > How can we achieve that every developer will cultivate it like this?
> 
> By giving a good example? ;-)

Yes, this would be the best. But when going through more than 1.500
commits it is really hard to decide by importance and to extract the
essentials from the logs.

> It's actually like that. For example, I never got the headers in compiler.h right. Now everyone just adds more stuff and it becomes more and more difficult to read and maintain this pile of sh*t. If you present a NEWS file like it is now, developers will simply add their SVN log entries. How should they know better?
> 
> But I fully agree, the VLC NEWS file is the way to go. So my initial
> 
> http://ethernut.svn.sourceforge.net/viewvc/ethernut/trunk/NEWS?revision=4307&view=markup
> 
> wasn't that bad, it was just too long.

It was totally fine! So what about making a cut in the NEWS file, keep
the history and add a little explanation with a sample on top. And from
now on only add important (to the enduser) changes while trying to
increase svn log quality as well by giving more explanatory descriptions
there too?

Bye,

Ole

-- 

Thermotemp GmbH, Embedded-IT

Embedded Hard-/ Software and Open Source Development, 
Integration and Consulting

http://www.embedded-it.de

Geschäftsstelle Siegen - Steinstraße 67 - D-57072 Siegen - 
tel +49 (0)271 5513597, +49 (0)271-73681 - fax +49 (0)271 736 97

Hauptsitz - Hademarscher Weg 7 - 13503 Berlin
Tel +49 (0)30 4315205 - Fax +49 (0)30 43665002
Geschäftsführer: Jörg Friedrichs, Ole Reinhardt
Handelsregister Berlin Charlottenburg HRB 45978 UstID DE 156329280 




More information about the En-Nut-Discussion mailing list