Hi fellow Debian folks,
Please, when composing debian/changelog for package releases, take a
moment to reflect on what you put into that file and how you phrase it.
It is a changelog, so should contain a list of changes.
This is not a list of changes:
python3-defaults (3.2.3-4) unstable; urgency=high
* py3clean: really close #681389
Yes, we have nifty mechanisms in place to close bugs based on magic
phrasing of changelog entries, but that's a bonus, not the main purpose
of that file.
Yes, it is possible to look up that bugreport online to learn more, or
sometimes (like this one) learn more from reading further back in the
logfile. But that's bad style.
Please write (brief but) explicitly what was changed in the packaging,
and please make each changelog section self-contained.
Something like this would be much better (yes it repeats some phrasing
from earlier changelog section to be self-contained):
python3-defaults (3.2.3-4) unstable; urgency=high
* py3clean: accept --package *and* directory name at the same time
(really this time). Closes: #681389.
Some use nifty tools to reuse titles from bugreports in changelog
entries. But often those titles describe what is the bug, not what will
be the change.
Please proofread your changelog before releasing a packaging, and make
sure all entries describe what was _changed_.
(no examples of ill-doing like that in today's changelog - great!)
Regards,
- Jonas
--
* Jonas Smedegaard - idealist & Internet-arkitekt
* Tlf.: +45 40843136 Website: http://dr.jones.dk/
[x] quote me freely [ ] ask before reusing [ ] keep private