Subject: Re: bug#51000: The Web manual situation is still needlessly confusing

From: Simon Tournier <[email-masked]>
Date: Wed, 27 Sep 2023 11:26:54 +0200

Hi,

On Mon, 04 Oct 2021 at 00:12, Tobias Geerinckx-Rice <[email-masked]> wrote:

> 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>.

Considering this hypothetical change, please note issue as reported by:

        bug#66189: [gnu.org #1975364] Broken link in Guix manual.
        "Therese Godefroy via RT" <[email-masked]>
        Mon, 25 Sep 2023 04:05:43 -0400
        id:[email-masked]
        https://issues.guix.gnu.org//66189
        https://issues.guix.gnu.org/msgid/[email-masked]
        https://yhetil.org/guix/[email-masked]

Quoting:

        > https://ftp.gnu.org/gnu/guix/guix-system-vm-image-e5f7c14.x86_64-linux.qcow2
        > in
        > https://guix.gnu.org/manual/devel/en/html_node/Running-Guix-in-a-VM.html
        > is broken.

    Yes, the link is automatically generated by,

        @url{@value{BASE-URL}/guix-system-vm-image-@value{VERSION}.x86_64-linux.qcow2}

    For instance, today the last manual correspond to Guix revision faf3ca
    and the link in this development manual reads,

        https://ftp.gnu.org/gnu/guix/guix-system-vm-image-fafd3ca.x86_64-linux.qcow2

    To my knowledge, no one is pushing to FTP all these images.

Cheers,
simon