Latest guix documentation - version number scrambled ?

  • Open
  • quality assurance status badge
Details
2 participants
  • Sébastien FARGE
  • zimoun
Owner
unassigned
Submitted by
Sébastien FARGE
Severity
normal
S
S
Sébastien FARGE wrote on 14 Nov 2022 11:36
(name . bug-guix)(address . bug-guix@gnu.org)
1493163212.367763.1668422211954.JavaMail.open-xchange@opme11oxm02nd1.pom.fr.intraorange
Attachment: file
Z
Z
zimoun wrote on 15 Nov 2022 15:45
87iljg8ef7.fsf@gmail.com
Hi,

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

Toggle quote (3 lines)
> version number is replaced by a strange number 'e26b529'.

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


Toggle quote (4 lines)
> 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. ;-)


Toggle quote (2 lines)
Specifically, the images are updated for each release, only.

For the latest images, please see:



Cheers,
simon
S
S
Sébastien FARGE wrote on 15 Nov 2022 16:56
668422246.697519.1668527798506.JavaMail.open-xchange@opme11oxm11nd1.pom.fr.intraorange
Attachment: file
Z
Z
zimoun wrote on 16 Nov 2022 10:06
87cz9n46af.fsf@gmail.com
Hi,

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

Toggle quote (10 lines)
>>> 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:


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:


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


Cheers,
simon
S
S
Sébastien FARGE wrote on 16 Nov 2022 12:26
522667048.64721.1668597977257.JavaMail.open-xchange@opme11oxm12nd1.pom.fr.intraorange
Attachment: file
?
Your comment

Commenting via the web interface is currently disabled.

To comment on this conversation send an email to 59277@debbugs.gnu.org

To respond to this issue using the mumi CLI, first switch to it
mumi current 59277
Then, you may apply the latest patchset in this issue (with sign off)
mumi am -- -s
Or, compose a reply to this issue
mumi compose
Or, send patches to this issue
mumi send-email *.patch