Hello, On Sat, Jul 02, 2016 at 01:03:01AM +0000, Felix Krull wrote: > I must say I'm a bit confused about how the Developer Reference > suggests to "concentrate on describing significant and user-visible > changes," but the informal advice I've heard on changelog entries was > always to be very detailed and granular, which to me seems more like a > job for VCS history than a changelog.
It's true that [email protected] has a culture of very detailed changelogs. I suspect that it is because it makes reviewing RFSs much easier. It is also good practice for team-maintained packages, which these days is a lot of them -- there were probably far fewer team-maintained packages when that part of the Developer's Reference was written. When deciding whether to add a changelog entry, I try to imagine that I'm someone trying to perform an NMU or team upload. What information would I want to know if I was doing that? That's a helpful heuristic. -- Sean Whitton
