[En-Nut-Discussion] Changelog for releases
ole.reinhardt at embedded-it.de
Tue Jun 19 16:27:39 CEST 2012
> > but there is no real changelog or release notes that explain what has
> > changes since the last release in a more clear and abstract way.
> I know what you mean, but please do not use the old ChangeLog for this,
> because it might become confusing. In no way I want to introduce that
> old behavior, where we used "I modified a few lines" for the commit and
> a real description in ChangeLog. The real description needs to go into
> the commit message. If these commit messages are not precise enough, we
> should improve them instead of opening another secondary log.
Yes, I agree. My basic intention was more the "release notes" instead of
> Release notes sounds much better to me. I agree, that we need some kind
> of overview. But for historical reasons ChangeLog wouldn't be the right
> name. We may, for example, use NEWS or README, which already exist in
> the repository.
The News file would be the right one in my eyes. And a short extract for
the website for each release.
> But your "kind of" is to vague to me. If we do not define this more
> exactly, we may end up with the same dissatisfying descriptions that we
> have now in the repository.
> In the first place, I'd divide the release notes into sections: Added, changed, fixed and removed.
> We need to specify, down to which level these entries should be listed
> outside of subversion. For example, I'd only list those changes, which
> significantly improve code size or performance, and changes which break
> existing applications.
Ok! But we should add important bug fixes because this could be a reason
for someone to switch to a new Nut/OS version.
If you like I could take some time and try to go throuch all commits
since (e.g. 2009) and extract the major changes and improvements there
to have a starting point.
Thermotemp GmbH, Embedded-IT
Embedded Hard-/ Software and Open Source Development,
Integration and Consulting
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