From mboxrd@z Thu Jan 1 00:00:00 1970 From: znavko@disroot.org Subject: Re: Deliver important Guix changes to users, please Date: Tue, 16 Apr 2019 17:21:26 +0000 Message-ID: References: <8736mjo29k.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="--=_RainLoop_654_704753795.1555435286" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:36381) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hGRmP-00031d-KV for guix-devel@gnu.org; Tue, 16 Apr 2019 13:21:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hGRmN-0005Df-VY for guix-devel@gnu.org; Tue, 16 Apr 2019 13:21:57 -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: =?utf-8?B?THVkb3ZpYyBDb3VydMOocw==?= Cc: guix-devel@gnu.org ----=_RainLoop_654_704753795.1555435286 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hello, Ludovic!=0AIf commit has important meaning for all Guix users, it = must give a short news entry for the users that are now developers and do= not really read git logs.=0A=0AHow to perform this?=0AThere are git comm= it messages that may have some specific rule for containing news.=0AFor e= xample, your commit https://git.savannah.gnu.org/cgit/guix.git/commit/gnu= /services?id=3D305a732a0a19c5810aab401aa7d70eba02ac386b=0Amay have 'messa= ge' field like this:=0Anews: services: xorg: Add 'set-xorg-configuration'= .=0A=0APlacing 'news:' makes this message important for the guix informer= . It will react to the 'news:' messages.=0A=0AIf it is not possible to us= e the 'message field', then need to add news.log file into Guix git tree,= and there, developers may add important news with their commits.=0A=0AAd= ding 'news' prefix means this message will regard as message for delivery= to Guix users when they run `guix pull` or when they order news with com= mand like `guix news`.=0AThe set of these news assembled from commits (or= from the news.log that also may contain date field) for any defined peri= od will be displaying to Guix users.=0A=0A`guix news` may have default pe= riod from the last `guix pull` running till now, also may have the 'perio= d' option.=0A=0AI really think your distribution is effective and powerfu= l.=0AIf I'd be a bank's sysadmin, I use Guix, having my own troubles in m= y local network, having my local substitute server and special Guix confi= gurations on each work place This news function can help me to solve: to = update or not to update.=0ASeeing if there are sensitive changes that may= break bank's work places, I will check the manual first before update.= =0AApril 15, 2019 12:56 PM, "Ludovic Court=C3=A8s" wrote:=0A Hello,=0A=0Aznavko@disroot.org (mailto:znavko@di= sroot.org) skribis:=0A I think it will be the best to have some layer of = informative support for updates. Like this:=0A=0A$ guix system --updates-= available=0ACommit: 1 [two days ago]=0AChanges: some services are availab= le now=0A=0ACommit: 2=0AChanges: [red]Switch to GDM in %desktop-services.= If your config is using %desktop-services, you=0Aneed to check manual pa= ges.[/red]=0A=0ACommit: 3 (latest)=0AChanges: gc clear-generations added= =0A$ guix package --updates-available=3D1week=0A90 new packages added.=0A= 15 packages updated.=0ANew packages:=0Aemacs-evil-lio, llgpl-license, ...= =0AChanged package:=0Aemacs 26.1 =3D> 26.2=0A...=0AThat will give some kn= owledge that your cool config might be wrong after update to the latest= =0Acommit, where dm was switched to gdm.=0A=0AI think news should be divi= ded to=0A- 'packages news' defining the period,=0A- and 'system news', th= e default period is from your last `guix system reconfigure config.scm` o= r=0Amay be your last generation's date till now,=0A=0AAnd sure news shoul= d be available from guix command.=0A=0AThere are tools for update guix fr= om substitute servers: local or Internet. There is much info in=0Acgit lo= gs on gnu server... Want to read more with guix.=0A=0AWould this kind of = messages help people to bypass troubles in convenient way? =0A=0A=E2=80= =98guix pull=E2=80=99 already provides high-level =E2=80=9Cpackage news= =E2=80=9D, but I agree it=E2=80=99d=0Abe nice to have a way to convey =E2= =80=9Csystem news=E2=80=9D and perhaps free-form=0Amessages like Debian= =E2=80=99s change logs.=0A=0AI suppose we could use some specially-format= ted Git commits to pass=0Amessages to users. I=E2=80=99m afraid it would = be hard to get those messages=0Atranslated.=0A=0AThoughts?=0A=0ANote that= the GDM change could also have been addressed by fixing=0A=E2=80=98modif= y-services=E2=80=99 to report about unmatched service types, for example.= =0A=0AThanks,=0ALudo=E2=80=99. ----=_RainLoop_654_704753795.1555435286 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
H= ello, Ludovic!
If commit has important meaning for all Guix users, it = must give a short news entry for the users that are now developers and do= not really read git logs.

How to perform this?
There are git commit messages that may have some specific rule for cont= aining news.
For example, your commit https://git.savannah.gnu.org/cgi= t/guix.git/commit/gnu/services?id=3D305a732a0a19c5810aab401aa7d70eba02ac3= 86b
may have 'message' field like this:
news: serv= ices: xorg: Add 'set-xorg-configuration'.

Placing 'news:' makes th= is message important for the guix informer. It will react to the 'news:' = messages.

If it is not possible to use the 'message field', then n= eed to add news.log file into Guix git tree, and there, = developers may add important news with their commits.

Adding 'news= ' prefix means this message will regard as message for delivery to Guix u= sers when they run `guix pull` or when they order news with command like = `guix news`.
The set of these news assembled from commits (or from the= news.log that also may contain date field) for any defined period will b= e displaying to Guix users.

`guix news` may have default period fr= om the last `guix pull` running till now, also may have the 'period' opti= on.

I really think your distribution is effective and powerful.If I'd be a bank's sysadmin, I use Guix, having my own troubles in my lo= cal network, having my local substitute server and special Guix configura= tions on each work place This news function can help me to solve: to upda= te or not to update.
Seeing if there are sensitive changes that may br= eak bank's work places, I will check the manual first before update.
<= br>
April 15, 2019 12:56 PM, "Ludovic Court=C3=A8s" <ludo@gnu.= org> wrote:
Hello,

znavko@disroo= t.org skribis:
I think it will be the best to have so= me layer of informative support for updates. Like this:

$ guix sys= tem --updates-available
Commit: 1 [two days ago]
Changes: some serv= ices are available now

Commit: 2
Changes: [red]Switch to GDM in= %desktop-services. If your config is using %desktop-services, you
nee= d to check manual pages.[/red]

Commit: 3 (latest)
Changes: gc c= lear-generations added
$ guix package --updates-available=3D1week
9= 0 new packages added.
15 packages updated.
New packages:
emacs-e= vil-lio, llgpl-license, ...
Changed package:
emacs 26.1 =3D> 26.= 2
...
That will give some knowledge that your cool config might be = wrong after update to the latest
commit, where dm was switched to gdm.=

I think news should be divided to
- 'packages news' defining t= he period,
- and 'system news', the default period is from your last `= guix system reconfigure config.scm` or
may be your last generation's d= ate till now,

And sure news should be available from guix command.=

There are tools for update guix from substitute servers: local or= Internet. There is much info in
cgit logs on gnu server... Want to re= ad more with guix.

Would this kind of messages help people to bypa= ss troubles in convenient way?


=E2=80=98guix pull=E2= =80=99 already provides high-level =E2=80=9Cpackage news=E2=80=9D, but I = agree it=E2=80=99d
be nice to have a way to convey =E2=80=9Csystem new= s=E2=80=9D and perhaps free-form
messages like Debian=E2=80=99s change= logs.

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.

Thoughts?

Note that the GDM = change could also have been addressed by fixing
=E2=80=98modify-servic= es=E2=80=99 to report about unmatched service types, for example.

= Thanks,
Ludo=E2=80=99.
----=_RainLoop_654_704753795.1555435286--