GNU bug report logs - #59277
Latest guix documentation - version number scrambled ?

Previous Next

To reply to this bug, email your comments to 59277 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

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

From: Sébastien FARGE <sebastien.farge925 <at> orange.fr>
To: bug-guix <bug-guix <at> gnu.org>
Subject: Latest guix documentation - version number scrambled ?
Date: Mon, 14 Nov 2022 11:36:51 +0100 (CET)

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

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

From: zimoun <zimon.toutoune <at> gmail.com>
To: Sébastien FARGE <sebastien.farge925 <at> orange.fr>,
 59277 <at> debbugs.gnu.org
Subject: Re: bug#59277: Latest guix documentation - version number scrambled ?
Date: Tue, 15 Nov 2022 15:45:16 +0100

Hi,

On lun., 14 nov. 2022 at 11:36, Sébastien FARGE <sebastien.farge925 <at> orange.fr> wrote:

> On the front page (https://guix.gnu.org/en/manual/devel/fr/) the
> version number is replaced by a strange number  'e26b529'.

This is the commit against which the documentation had been built.


> A consequence is that all links using the version number are broken.
>
> For exemple, on the page : https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Stick

Indeed, but the image is not built for each commit.  Well, I do not know
if it is fixable – or if it makes sense to fix.  It is the devel manual
after all. ;-)


> i failed to download the iso image named : https://ftp.gnu.org/gnu/guix/guix-system-install-e26b529.x86_64-linux.iso’

Specifically, the images are updated for each release, only.

For the latest images, please see:

    https://guix.gnu.org/en/download/latest/


Cheers,
simon

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

From: Sébastien FARGE <sebastien.farge925 <at> orange.fr>
To: zimoun <zimon.toutoune <at> gmail.com>, 59277 <at> debbugs.gnu.org
Subject: Re: bug#59277: Latest guix documentation - version number scrambled ?
Date: Tue, 15 Nov 2022 16:56:38 +0100 (CET)

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

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

From: zimoun <zimon.toutoune <at> gmail.com>
To: Sébastien FARGE <sebastien.farge925 <at> orange.fr>,
 59277 <at> debbugs.gnu.org
Subject: Re: bug#59277: Latest guix documentation - version number scrambled ?
Date: Wed, 16 Nov 2022 10:06:48 +0100

Hi,

On Tue, 15 Nov 2022 at 16:56, Sébastien FARGE <sebastien.farge925 <at> orange.fr> wrote:

>>>  A consequence is that all links using the version number are broken.
>>>
>>>  For exemple, on the page : https://guix.gnu.org/en/manual/devel/en/html_node/USB-Stick-and-DVD-Installation.html#Copying-to-a-USB-Stick
>>
>>  Indeed, but the image is not built for each commit. Well, I do not know
>>  if it is fixable – or if it makes sense to fix. It is the devel manual
>>  after all. ;-)
>
> Does a documentation with broken links makes sense ?

The point is that the (devel) manual is referring to some release only URLs:

    https://ftp.gnu.org/gnu/guix/

The images there are only updated when a new release is out.  It is not
a rolling-release URL updated by the CI but a very stable URL manually
updated (I guess).

This URL in the manual is generated by

@indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso},

where VERSION is from version.texi generated at compile-time, IIRC.

The simplest is to add a warning note mentioning the issue and pointing to:

    https://guix.gnu.org/en/download/latest/

A more convoluted solution would to introduce another version label as
RELEASE-VERSION and use it in these places in the manual.


Cheers,
simon

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

From: Sébastien FARGE <sebastien.farge925 <at> orange.fr>
To: zimoun <zimon.toutoune <at> gmail.com>, 59277 <at> debbugs.gnu.org
Subject: Re: bug#59277: Latest guix documentation - version number scrambled ?
Date: Wed, 16 Nov 2022 12:26:17 +0100 (CET)

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

Previous Next

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