GNU bug report logs - #51000
The Web manual situation is still needlessly confusing

Previous Next

Full log

Message #11 received at 51000 <at> debbugs.gnu.org (full text, mbox):

From: Efraim Flashner <efraim <at> flashner.co.il>
To: Tobias Geerinckx-Rice <me <at> tobias.gr>
Cc: 51000 <at> debbugs.gnu.org
Subject: Re: bug#51000: The Web manual situation is still needlessly confusing
Date: Mon, 4 Oct 2021 09:31:59 +0300

[Message part 1 (text/plain, inline)]

On Mon, Oct 04, 2021 at 12:12:55AM +0200, Tobias Geerinckx-Rice via Bug reports for GNU Guix wrote:
> Good evening Guix!
> 
> Nary a literal week goes by that someone doesn't post confusion about this
> or that not being in ‘the manual’, where the manual turns out to be
> <https://guix.gnu.org/manual/en/guix.html> instead of the one actually
> shipped with their Guix.
> 
> The current solution is pointing them to
> <https://guix.gnu.org/manual/devel/en/guix.html> and resetting the timer.
> 
> Instead:
> 
> - We should make <https://guix.gnu.org/manual/en/guix.html> the  ‘devel’
> version, and move the stable version to to a versioned  URL like
> <https://guix.gnu.org/manual/1.3.0/en/guix.html>.
> 
> - Both manuals should have a gorgeous CSS box at the very top  clearly
> explaining their nature.

Here is an untested patch against guix-maintenance to change the manual
locations. It doesn't take into account any changes needed in the
website itself to add a pointer to the 1.3.0 manual.


-- 
Efraim Flashner   <efraim <at> flashner.co.il>   רנשלפ םירפא
GPG key = A28B F40C 3E55 1372 662D  14F7 41AA E7DC CA3D 8351
Confidentiality cannot be guaranteed on emails sent or received unencrypted

[0001-hydra-Move-guix-manual-URLs.patch (text/plain, attachment)]

[signature.asc (application/pgp-signature, inline)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.