From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 04:33:37 2022 Received: (at 59277) by debbugs.gnu.org; 16 Nov 2022 09:33:37 +0000 Received: from localhost ([127.0.0.1]:56101 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovEnY-0006WF-Rb for submit@debbugs.gnu.org; Wed, 16 Nov 2022 04:33:37 -0500 Received: from mail-wm1-f48.google.com ([209.85.128.48]:37723) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovEnS-0006VK-7h for 59277@debbugs.gnu.org; Wed, 16 Nov 2022 04:33:34 -0500 Received: by mail-wm1-f48.google.com with SMTP id ay14-20020a05600c1e0e00b003cf6ab34b61so1150499wmb.2 for <59277@debbugs.gnu.org>; Wed, 16 Nov 2022 01:33:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=fqSwxJ7yUOEGf4Pb21H6hIFM2TYT64n6/zn/pdoqXKg=; b=PvKLOtFguvCr338ws4NjCl+EkvGcOCSMGhBFISMP4Vw6jIHjMKu2/4BxNwWdHJXTt/ kr3UeJJMuejnvo+NXRe5WplQQPB+R4uuRZXm9lHdl5uCYj0YKHr5b9tLuCCfNhOocI62 T3wPYTSyQjd/hgcVZxrpRSbkh5+YqjnM0zOoIAN/3HCYHlmdBkuYPl0iP2GVjab2efkI +chi7f5vaLU5nj9P/nqbNdifyQMVxb2fqltvmdn9oz+mOCZruXXP63t78zGfZjMz6Lyx lqYwM5sDIZ0erkrALQOlDkYSJJR+UAIRJGF7CKeKNRugL06bIWLTnITD8GLoH6P0P+3V iVxw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:to:from:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to; bh=fqSwxJ7yUOEGf4Pb21H6hIFM2TYT64n6/zn/pdoqXKg=; b=aGZGRyVFVy4gcFRF/pSpd5LTyKafS6lJgvbFmiNBJIYz1vyreDck4SbLdLBJQrkVCt tGT4HErlwc0RFdmO3YcgkUjDqmiO+ai9sueW35CMraBYBGcpDoalSyT6Z5T9nM4FjsAI 3WXnEULKRX3Ac/T7AwqB2CYIebD46BYEFdsAYPv2cpiZWDQMcWENi9Cnyr/DDGR/OctH bCnza4T2jy+MG/SxuAGH0gfkJbDythP21Kt3SgZcXUc79WA/Bo9DFQyzuQbQZHqEgyzb jmS0GMEGAwFJ89bTFpx25w3X68glq5d+QO0h03bgYWTgvCpGHs4HF9LESNRJvk8Tu2Nr AlWg== X-Gm-Message-State: ANoB5pk1+5jzx7mju8SURzQrMZ9s/b6+nW8wxTRyn+i5oFBhs+3zCS7g g9c9/e82mSRN+gWYcX+aTrH9ACW1tnY= X-Google-Smtp-Source: AA0mqf49lH7nIEgDRYTGvrwDJcu3jVDx7u1mJNQMXIBMHlW712A6a5MnGbs4lw5WC+adfydAriInOA== X-Received: by 2002:a05:600c:358c:b0:3c6:c089:9810 with SMTP id p12-20020a05600c358c00b003c6c0899810mr1476786wmq.60.1668591204529; Wed, 16 Nov 2022 01:33:24 -0800 (PST) Received: from pfiuh07 ([193.48.40.241]) by smtp.gmail.com with ESMTPSA id b3-20020adff903000000b002366fb99cdasm14506959wrr.50.2022.11.16.01.33.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Nov 2022 01:33:23 -0800 (PST) From: zimoun To: =?utf-8?Q?S=C3=A9bastien?= FARGE , 59277@debbugs.gnu.org Subject: Re: bug#59277: Latest guix documentation - version number scrambled ? In-Reply-To: <668422246.697519.1668527798506.JavaMail.open-xchange@opme11oxm11nd1.pom.fr.intraorange> References: <956989375.2295039.1667428307829.JavaMail.open-xchange@opme11oxm08nd1.pom.fr.intraorange> <1493163212.367763.1668422211954.JavaMail.open-xchange@opme11oxm02nd1.pom.fr.intraorange> <87iljg8ef7.fsf@gmail.com> <668422246.697519.1668527798506.JavaMail.open-xchange@opme11oxm11nd1.pom.fr.intraorange> Date: Wed, 16 Nov 2022 10:06:48 +0100 Message-ID: <87cz9n46af.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 59277 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, On Tue, 15 Nov 2022 at 16:56, S=C3=A9bastien FARGE 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/htm= l_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 =E2=80=93 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-li= nux.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