← Back to team overview

ubuntu-phone team mailing list archive

Re: Developers: changelog quality

 

Am Freitag, den 06.06.2014, 11:47 -0700 schrieb Robert Park:

> > Today we already share many packages on the phone with the general
> > distro and distro people will want to be able to know what's going on
> > with the packages ... the more we work towards convergence the closer
> > these worlds will have to cooperate and info needs to get over the
> > fence, lets design our processes in a way that this is possible ;)
> 
> Yeah, maybe certain projects could elect to forego debian/changelog,
> and simply have a link to the VCS changelog, so that way people who
> want debian/changelog aren't left with nothing, while upstreams don't
> have to duplicate their commit messages... Maybe something like
> this...
> 
> http://bazaar.launchpad.net/~ubuntu-elisp/emacs/snapshot-packaging/view/head:/debian/changelog
so this links to:

emacs-snapshot (0-0ubuntu1) UNRELEASED; urgency=low

  * Dummy changelog used exclusively for launchpad recipe auto builds.
    You might be interested in one of these instead:
    - http://bazaar.launchpad.net/~vcs-imports/emacs/trunk/changes
    - http://bazaar.launchpad.net/~ubuntu-elisp/emacs/snapshot-packaging/changes

 -- Robert Bruce Park <r@xxxxxxxx>  Tue, 09 Apr 2013 19:35:50 -0700

How about dropping the "You might be interested ..." and instead have something like:

vim (0-0ubuntu1) UNRELEASED; urgency=low

 * Auto generated list of dependency changes from the Ubuntu CI system:
    Added libfoople dependency
   Removed libbar dependency

 * Auto generated changelog entry from the Ubuntu CI system.
    - Commit message of the foo bar branch MP
      http://bazaar.launchpad.net/~foo/bar/trunk/changes
    - Commit message of the baz branch MP
      http://bazaar.launchpad.net/~baz-team/baz/feature/fixes

 -- Oliver Grawert <ogra@xxxxxxxxxx> Sat, 07 Jun 2014 10:16:06 +0200

The first bit would need a tool with a little debdiff magic that scans debian/control for added/removed debs 
The second bit would need a generator that automatically adds a branch link together with the commit 
message (i suppose we already have something like this running, just not in its best setup given the changelog entries i see).

Now if we have a policy that the commit message has to be a *descriptive* one to three liner that has to be 
written in a way that other devs understand the change we are set ... this puts minimal pressure on the committer 
and reviewer to keep an eye open for proper commit messages but would need some work to do proper automation 
for the other bits ...

ciao
	oli

Attachment: signature.asc
Description: This is a digitally signed message part


References