From mboxrd@z Thu Jan 1 00:00:00 1970 From: Tobias Geerinckx-Rice Subject: Re: Deliver important Guix changes to users, please Date: Tue, 16 Apr 2019 20:19:26 +0200 Message-ID: <878sw9ak41.fsf@nckx> References: <8736mjo29k.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:48319) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGSgE-0003qb-27 for guix-devel@gnu.org; Tue, 16 Apr 2019 14:19:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hGSgC-00024c-2I for guix-devel@gnu.org; Tue, 16 Apr 2019 14:19:38 -0400 In-reply-to: <8736mjo29k.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: guix-devel@gnu.org --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Ludo', Guix, As your friendly neighbourhood update bot, I read a lot of change=20 logs. The worst are the one-log text file with =E2=80=99lol use git now,=20 change logs are obsolete!1=E2=80=99. Utterly clueless, distressingly=20 common. The best ones are usually called NEWS for some reason (go GNU!)=20 and are manually maintained, in sync with the code changes but not=20 forced on top of them; using git but not abusing it. Ludovic Court=C3=A8s wrote: > I suppose we could use some specially-formatted Git commits to=20 > pass > messages to users. I=E2=80=99m afraid it would be hard to get those=20 > messages > translated. I beg you not to do this, even as fodder for a friendly front end.=20 Just use a structured text file. Add dates. Affected packages.=20 Metadata. Hell, use sexps if you like. Fix typos/add caveats to=20 old news items when needed, not through errata commits. Don't=20 confuse git log with a log like some people confuse git blame with=20 comments. That is all, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHQEARYKAB0WIQT12iAyS4c9C3o4dnINsP+IT1VteQUCXLYcrgAKCRANsP+IT1Vt eegzAQCD7LpSdVCqYeI4RoiqyefxmalCQ73CyiQpuCb4ZY5IJAD2Kn3Sn0kHKMS9 cv2/OdAfeWjNI00F2+TlRJUQlJB1Bg== =SwHz -----END PGP SIGNATURE----- --=-=-=--