Changelog entries best practices?

[Jurij Smakov <jurij@wooyd.org>]

Hello,

Today a (minor) bug 306382 was opened (and promptly closed :-) against the 
kernel-image package, which does not contain nothing in changelog except 
"Build against 2.6.11-3". While this is perfectly fine, it is easy to 
understand frustration of people, who are not that proficient in the 
kernel build procedure. They don't have an obvious place to look for a 
changelog entry, so I propose to include a standard phrase in every 
kernel-image changelog, along the lines of

  * Built against kernel-source 2.x.y-z. For a complete list of changes
    consult the kernel-source changelog, which may be accessed online
    at http://changelogs.debian.net/kernel-source-2.x.y

Myself, I have bumped into another changelog-related "problem". Currently 
there seems to be no convention on where the new changelog entries should 
be added upon modification of kernel-source in svn. It looks like some 
people append them to the end of existing changelog entry, while others 
(like me) prefer to insert it in the beginning :-). As the choice is 
pretty arbitrary, I propose to insert the new entries in the beginning of 
the file, to avoid duplications.

If there are no serious objections, I suggest to adopt these proposals and 
introduce appropriate changes into the trunk/README file.

Best regards,

Jurij Smakov                                        jurij@wooyd.org
Key: http://www.wooyd.org/pgpkey/                   KeyID: C99E03CC