unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
* Please write "Update to <version>" instead of "Update snapshot"
@ 2017-11-26  0:43 Mark H Weaver
  2017-11-26 19:03 ` Leo Famulari
  0 siblings, 1 reply; 6+ messages in thread
From: Mark H Weaver @ 2017-11-26  0:43 UTC (permalink / raw)
  To: guix-devel

Hello Guix,

I'd like to propose that we deprecate the practice of simply writing
"Update snapshot" in the summary line of software updates, and instead
consistently write "Update to <version>", as we do for the vast majority
of updates.

This practice seems to have originated with our 'guix-devel' package,
and iirc for a long time that was the sole exception to our usual
convention.  However, recently I've seen this practice gradually
spreading to other packages, e.g. gcl, kodi, xf86-video-intel, cuirass,
guile2.2-ssh, etc.  I've CC'd the few Guix developers who have started
doing this.

In my opinion, the version number is a very useful piece of information
to see for update commits when browsing the commit history.  I regard
the practice of omitting the version number to be a slowly creeping
regression in our otherwise exceptionally good conventions for commit
logs.  I humbly propose that we nip this regression in the bud.

What do you think?

      Mark

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2017-11-26 22:09 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
     [not found] <20171109014628.6934.66587@vcs0.savannah.gnu.org>
     [not found] ` <20171109014630.1CC31201B8@vcs0.savannah.gnu.org>
2017-11-13  4:14   ` 01/01: gnu: totem: Enable parallel build Mark H Weaver
2017-11-13 12:49     ` Kei Kebreau
2017-11-26  1:21       ` Please write "Update to <version>" instead of "Update snapshot" Kei Kebreau
2017-11-26  0:43 Mark H Weaver
2017-11-26 19:03 ` Leo Famulari
2017-11-26 22:09   ` Ludovic Courtès

Code repositories for project(s) associated with this public inbox

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

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).