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 23:38:13 +0200 Message-ID: <874l6xaawq.fsf@nckx> References: <8736mjo29k.fsf@gnu.org> <878sw9ak41.fsf@nckx> <87bm15d76c.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]:38663) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGVma-0007bu-4N for guix-devel@gnu.org; Tue, 16 Apr 2019 17:38:24 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hGVmW-0006c9-UL for guix-devel@gnu.org; Tue, 16 Apr 2019 17:38:22 -0400 In-reply-to: <87bm15d76c.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', Ludovic Court=C3=A8s wrote: > Tobias Geerinckx-Rice skribis: > >> 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 >>> messages >>> translated. >> >> I beg you not to do this, even as fodder for a friendly front >> end. Just use a structured text file. Add dates. Affected >> packages. Metadata. Hell, use sexps if you like. Fix=20 >> typos/add >> caveats to old news items when needed, not through errata=20 >> commits. >> Don't confuse git log with a log like some people confuse git=20 >> blame >> with comments. > > The interesting part here is that commits are anchored in the=20 > version > control history. Thus, you could easily tell whether a news=20 > item is > relevant or not. Oh, sure. To clarify: I'm pro storing the news items in the repository. In=20 fact I think it's a bad idea to keep it anywhere else (such as the=20 Web site, but by all means generate a pretty news feed from=20 guix.git on there). I just think it should be a regular file. Don't shove News=20 metadata into the commit message. When it makes sense, update the=20 News file(s) in the same commit as the code =E2=80=94 as is done for other= =20 documentation, which is what this is. Kind regards, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQT12iAyS4c9C3o4dnINsP+IT1VteQUCXLZLRQAKCRANsP+IT1Vt eWQTAP0flE6yYToj+EsGok8Q7FN5YNc+1+4hbB6Mb/bIZks0mgD+P6dzhEMADBrb x3Hb0jJ0gapByVTCqGbwr8MboWRf+gw= =o/sd -----END PGP SIGNATURE----- --=-=-=--