From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= Subject: Re: Deliver important Guix changes to users, please Date: Tue, 16 Apr 2019 22:30:35 +0200 Message-ID: <87bm15d76c.fsf@gnu.org> References: <8736mjo29k.fsf@gnu.org> <878sw9ak41.fsf@nckx> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([209.51.188.92]:48632) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGUj4-0008Rp-Q7 for guix-devel@gnu.org; Tue, 16 Apr 2019 16:30:44 -0400 In-Reply-To: <878sw9ak41.fsf@nckx> (Tobias Geerinckx-Rice's message of "Tue, 16 Apr 2019 20:19:26 +0200") 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: Tobias Geerinckx-Rice Cc: guix-devel@gnu.org Hello, Tobias Geerinckx-Rice skribis: > Ludovic Court=C3=A8s wrote: >> I suppose we could use some specially-formatted Git commits to 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 typos/add > caveats to old news items when needed, not through errata commits. > Don't confuse git log with a log like some people confuse git blame > with comments. The interesting part here is that commits are anchored in the version control history. Thus, you could easily tell whether a news item is relevant or not. If you store news separately, well I guess you could just write the commit to which the news item applies. Hmm, maybe you=E2=80=99re right! So we could have, say: .news/[0-9]+.news (every other file would be ignored) and then some sexp format, say: (news (entry (title "GDM is now the default") (commit "cabba9e") (body "Hey, GDM=E2=80=99s in the house!")) (entry (title "News are here") =E2=80=A6)) and we could maybe even have a PO file for this. How does that sound? (Probably post 1.0, but worth discussing.) Ludo=E2=80=99.