From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-dev-return-14383-arch-gentoo-dev=gentoo.org@lists.gentoo.org>
Received: (qmail 16783 invoked from network); 23 Jul 2004 04:22:47 +0000
Received: from smtp.gentoo.org (156.56.111.197)
  by lists.gentoo.org with AES256-SHA encrypted SMTP; 23 Jul 2004 04:22:47 +0000
Received: from lists.gentoo.org ([156.56.111.196] helo=parrot.gentoo.org)
	by smtp.gentoo.org with esmtp (Exim 4.34)
	id 1Bnra1-0002Cb-LU
	for arch-gentoo-dev@lists.gentoo.org; Fri, 23 Jul 2004 04:22:45 +0000
Received: (qmail 29257 invoked by uid 89); 23 Jul 2004 04:22:45 +0000
Mailing-List: contact gentoo-dev-help@gentoo.org; run by ezmlm
Precedence: bulk
List-Post: <mailto:gentoo-dev@gentoo.org>
List-Help: <mailto:gentoo-dev-help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev-unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-dev-subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@gentoo.org
Received: (qmail 5142 invoked from network); 23 Jul 2004 04:22:44 +0000
From: Andrew Cowie <andrew@operationaldynamics.com>
To: stuart@gentoo.org
Cc: gentoo-dev@lists.gentoo.org
In-Reply-To: <200407211608.13130.stuart@gentoo.org>
References: <20040720131405.GW18023@mail.lieber.org>
	 <Pine.LNX.4.58.0407210726520.1279@stargazer.weeve.org>
	 <200407211647.21609.carlo@gentoo.org>
	 <200407211608.13130.stuart@gentoo.org>
Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-vT+T5OmahcXemLfdzWI4"
Organization: Operational Dynamics
Date: Fri, 23 Jul 2004 14:22:42 +1000
Message-Id: <1090556562.24455.28.camel@localhost>
Mime-Version: 1.0
X-Mailer: Evolution 1.5.90 
Subject: Re: [gentoo-dev] Revisiting GLEP 19
X-Archives-Salt: d584334c-a403-430f-b933-3c33d09a59f0
X-Archives-Hash: e34c85a6a6ebba3a9369461a5bcf3961

--=-vT+T5OmahcXemLfdzWI4
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

On Wed, 2004-07-21 at 16:08 +0100, Stuart Herbert wrote:
> Think of it this way.  Good change information, like good QA, is somethin=
g=20
> that is part of the professional behaviour reasonably expected of a softw=
are=20
> engineer.

Someone else alluded to this, and I'd just like to reinforce the point:
in terms of assessing the risk of a potential upgrade, some sense of
what has changed is necessary.

Unfortunately, the typical ChangeLog in portage is:

  18 Feb 2004; David Holm <dholm@gentoo.org> db-4.2.52_p1.ebuild:
  Added to ~ppc.

and

  *evolution-1.4.6 (22 Mar 2004)

  22 Mar 2004; Alastair Tse <liquidx@gentoo.org> evolution-1.4.6.ebuild:
  version bump

the trouble is especially evident in the second example. What are the
changes between evo 1.4.5 and evo 1.4.6?

That, of course, is answered by the contents of the upstream ChangeLog,
which there usually is one. In this case it is:

  http://developer.ximian.com/projects/evolution/release_notes/1.4.6.html

Which is actually what I, in an enterprise deployment manager role, need
to know about before I can make an upgrade decision. The stuff about
arches being marked stable, etc, is, while internally important, not
terribly interesting compared to this.

It would be fantastic if we can find a way to include such information.
After all, the developer doing the version bump (or better yet, the user
making the bug report) probably at least had a look at the changes list,
where ever it is to be found. That information should at least be
hyperlinked, and, far better - (especially if we're switching to an XML
format) included in Gentoo's ChangeLogs.

Cheers,

AfC

--=20
Andrew Frederick Cowie

OPERATIONAL DYNAMICS
Operations Consultants and Infrastructure Engineers

http://www.operationaldynamics.com/

--=-vT+T5OmahcXemLfdzWI4
Content-Type: application/pgp-signature; name=signature.asc
Content-Description: This is a digitally signed message part

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)

iD8DBQBBAJKSLVETDFf2570RAkrWAJwPC1ZJwlVxopf5gPaBBg012gQBqwCfSOIT
Pg7Bfx6UsV3Kz740t+P7kAs=
=E4PA
-----END PGP SIGNATURE-----

--=-vT+T5OmahcXemLfdzWI4--