all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: znavko@disroot.org
To: "Ludovic Courtès" <ludo@gnu.org>
Cc: guix-devel@gnu.org
Subject: Re: Deliver important Guix changes to users, please
Date: Tue, 16 Apr 2019 17:21:26 +0000	[thread overview]
Message-ID: <e110367bdfa83918556110b2a7557fc4@disroot.org> (raw)
In-Reply-To: <8736mjo29k.fsf@gnu.org>

[-- Attachment #1: Type: text/plain, Size: 3588 bytes --]

Hello, 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 containing news.
For example, your commit https://git.savannah.gnu.org/cgit/guix.git/commit/gnu/services?id=305a732a0a19c5810aab401aa7d70eba02ac386b
may have 'message' field like this:
news: services: xorg: Add 'set-xorg-configuration'.

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

If it is not possible to use the 'message field', then need 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 users 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 be displaying to Guix users.

`guix news` may have default period from the last `guix pull` running till now, also may have the 'period' option.

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 local network, having my local substitute server and special Guix configurations on each work place This news function can help me to solve: to update or not to update.
Seeing if there are sensitive changes that may break bank's work places, I will check the manual first before update.
April 15, 2019 12:56 PM, "Ludovic Courtès" <ludo@gnu.org (mailto:ludo@gnu.org)> wrote:
 Hello,

znavko@disroot.org (mailto:znavko@disroot.org) skribis:
 I think it will be the best to have some layer of informative support for updates. Like this:

$ guix system --updates-available
Commit: 1 [two days ago]
Changes: some services are available now

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

Commit: 3 (latest)
Changes: gc clear-generations added
$ guix package --updates-available=1week
90 new packages added.
15 packages updated.
New packages:
emacs-evil-lio, llgpl-license, ...
Changed package:
emacs 26.1 => 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 the period,
- and 'system news', the default period is from your last `guix system reconfigure config.scm` or
may be your last generation's date 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 read more with guix.

Would this kind of messages help people to bypass troubles in convenient way? 

‘guix pull’ already provides high-level “package news”, but I agree it’d
be nice to have a way to convey “system news” and perhaps free-form
messages like Debian’s change logs.

I suppose we could use some specially-formatted Git commits to pass
messages to users. I’m afraid it would be hard to get those messages
translated.

Thoughts?

Note that the GDM change could also have been addressed by fixing
‘modify-services’ to report about unmatched service types, for example.

Thanks,
Ludo’.

[-- Attachment #2: Type: text/html, Size: 4191 bytes --]

      parent reply	other threads:[~2019-04-16 17:21 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-04-14 11:25 Deliver important Guix changes to users, please znavko
2019-04-15 12:56 ` Ludovic Courtès
2019-04-16  3:55   ` Amin Bandali
2019-04-16 19:15     ` Brett Gilio
2019-04-16 18:19   ` Tobias Geerinckx-Rice
2019-04-16 18:27     ` Tobias Geerinckx-Rice
2019-04-16 20:30     ` Ludovic Courtès
2019-04-16 21:38       ` Tobias Geerinckx-Rice
2019-04-16 17:21 ` znavko [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=e110367bdfa83918556110b2a7557fc4@disroot.org \
    --to=znavko@disroot.org \
    --cc=guix-devel@gnu.org \
    --cc=ludo@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.