Received: (at 51000) by debbugs.gnu.org; 2 Oct 2023 09:21:18 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Oct 02 05:21:18 2023
Received: from localhost ([127.0.0.1]:36035 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1qnF77-0007Qn-Ru
for submit <at> debbugs.gnu.org; Mon, 02 Oct 2023 05:21:18 -0400
Received: from mail-wm1-x32f.google.com ([2a00:1450:4864:20::32f]:41426)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <zimon.toutoune@HIDDEN>) id 1qnF6v-0007PW-6H
for 51000 <at> debbugs.gnu.org; Mon, 02 Oct 2023 05:21:09 -0400
Received: by mail-wm1-x32f.google.com with SMTP id
5b1f17b1804b1-40651b22977so10565895e9.1
for <51000 <at> debbugs.gnu.org>; Mon, 02 Oct 2023 02:20:48 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20230601; t=1696238442; x=1696843242; darn=debbugs.gnu.org;
h=content-transfer-encoding:mime-version:user-agent:message-id
:in-reply-to:date:references:subject:cc:to:from:from:to:cc:subject
:date:message-id:reply-to;
bh=ps4zm4W4nVw8S3KiFf3VH1dtbpxZ+SMET4A61fbmdpM=;
b=e9OX9ZDhc8Fb1nnyYPkI8zOH4Wz5SIll7/QKqXyov7ZYkOQge0pmr6KELUJcNEcHkL
6bRAMD6GgBdIQnHTLtH8XxBRzM5CQfj2ZXdO7g61uRZBmH8xC69Rts6y5wtzO6oPYJ0S
pktH0AQASrdBqgZajWA3BOCBru+k1azkffqqb1aXKwE+MrAPOdKd043f6LmMFzV5mdE9
KDkkubSH9Pqddlxy4vo2s5wTDJgfCaKeiRAo3cNuq7MkHvvjAp1F4FB92qZxcjNWyxQb
KYHuhGlgS0XFqqtgi3VCKfX7jxeNRr2dDmTAkFsbWd9k/rto6FUyHEaUdSHxHBt8azv7
m94A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1696238442; x=1696843242;
h=content-transfer-encoding:mime-version:user-agent:message-id
:in-reply-to:date:references:subject:cc:to:from:x-gm-message-state
:from:to:cc:subject:date:message-id:reply-to;
bh=ps4zm4W4nVw8S3KiFf3VH1dtbpxZ+SMET4A61fbmdpM=;
b=YJ8sLtEV5DQPBFLrbX6WUdu1fgigEmsWk4ohBNfRlWscVDUYNoEhewShiYrlotPmJ+
mGpB9Vio8AoaUrhDOGC00k8Hgs5XKCSv/0k4+3D7SpTPxb2ebDjqpB1uzoZLa6dzCl11
QxBKNvcAhBXOoOdiQszkgX/3a0tbHbQG0Wy6Xyc2p4uo6k4jZRNc3NQUVGiVO6JVNbc1
aHfutL1OMcp3YxVZ4sSyjicrpjn921kMHO8oXJMcZSgHQpxCULsIIe5jAn0JRMJXELLj
0x1CZ6xtAFbd21zcpZFApGizjRkOS1StxAUSP8dZIL/LfyHKQWDTaxZjnKNQDuA4Tfd/
vCPQ==
X-Gm-Message-State: AOJu0YzZeMNNGjaQA+GVoEuc0TofH89IKEsHtzxejpnDgGlMT2lmCpac
lrfpvaHNhrwD0w2CH4sbMAcjFC/JhKU=
X-Google-Smtp-Source: AGHT+IGjYkcskgVDJiiV2ij1oXLSCK/hsMKSJ58C8iouockrn8/+sK1qI/xjoerb7dmdSKDhtJQK5g==
X-Received: by 2002:a05:600c:4f94:b0:405:4721:800 with SMTP id
n20-20020a05600c4f9400b0040547210800mr10432390wmq.1.1696238442384;
Mon, 02 Oct 2023 02:20:42 -0700 (PDT)
Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e])
by smtp.gmail.com with ESMTPSA id
k2-20020a05600c1c8200b004065d72ab19sm6805388wms.0.2023.10.02.02.20.41
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Mon, 02 Oct 2023 02:20:42 -0700 (PDT)
From: Simon Tournier <zimon.toutoune@HIDDEN>
To: Tobias Geerinckx-Rice <me@HIDDEN>
Subject: Re: bug#51000: The Web manual situation is still needlessly confusing
References: <87ilydycps.fsf@nckx>
Date: Wed, 27 Sep 2023 11:26:54 +0200
In-Reply-To: <87ilydycps.fsf@nckx> (Tobias Geerinckx-Rice's message of "Mon,
04 Oct 2021 00:12:55 +0200")
Message-ID: <86pm24hspt.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 2.1 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: Hi, On Mon, 04 Oct 2021 at 00:12, Tobias Geerinckx-Rice 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/gui [...]
Content analysis details: (2.1 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
-0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/,
no trust
[2a00:1450:4864:20:0:0:0:32f listed in]
[list.dnswl.org]
-0.0 SPF_PASS SPF: sender matches SPF record
2.1 DATE_IN_PAST_96_XX Date: is 96 hours or more before Received:
date
0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail
provider (zimon.toutoune[at]gmail.com)
0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record
X-Debbugs-Envelope-To: 51000
Cc: 51000 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.1 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
has NOT identified this incoming email as spam. The original
message has been attached to this so you can view it or label
similar future email. If you have any questions, see
the administrator of that system for details.
Content preview: Hi, On Mon, 04 Oct 2021 at 00:12, Tobias Geerinckx-Rice 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/gui [...]
Content analysis details: (1.1 points, 10.0 required)
pts rule name description
---- ---------------------- --------------------------------------------------
-0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/,
no trust
[2a00:1450:4864:20:0:0:0:32f listed in]
[list.dnswl.org]
-0.0 SPF_PASS SPF: sender matches SPF record
2.1 DATE_IN_PAST_96_XX Date: is 96 hours or more before Received:
date
0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail
provider (zimon.toutoune[at]gmail.com)
0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record
-1.0 MAILING_LIST_MULTI Multiple indicators imply a widely-seen list
manager
Hi,
On Mon, 04 Oct 2021 at 00:12, Tobias Geerinckx-Rice <me@HIDDEN> wrote:
> Instead:
>
> - We should make <https://guix.gnu.org/manual/en/guix.html> the =E2=80=
=98devel=E2=80=99
> 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" <webmasters-comment@HIDDEN>
Mon, 25 Sep 2023 04:05:43 -0400
id:rt-4.2.16-14-g9a593ee-17542-1695629143-1144.1975364-8-0@HIDDEN=
rg
https://issues.guix.gnu.org//66189
https://issues.guix.gnu.org/msgid/rt-4.2.16-14-g9a593ee-17542-16956=
29143-1144.1975364-8-0@HIDDEN
https://yhetil.org/guix/rt-4.2.16-14-g9a593ee-17542-1695629143-1144=
.1975364-8-0@HIDDEN
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-l=
inux.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-li=
nux.qcow2
To my knowledge, no one is pushing to FTP all these images.
Cheers,
simon
bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.Received: (at 51000) by debbugs.gnu.org; 22 May 2023 02:00:05 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun May 21 22:00:04 2023 Received: from localhost ([127.0.0.1]:33079 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1q0uqC-0003XT-Cj for submit <at> debbugs.gnu.org; Sun, 21 May 2023 22:00:04 -0400 Received: from sail-ipv4.us-core.com ([208.82.101.137]:42674) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <felix.lechner@HIDDEN>) id 1q0uq9-0003Tk-Ee for 51000 <at> debbugs.gnu.org; Sun, 21 May 2023 22:00:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=2017; bh=dVMcmiizfCz7dbZ teIdpemkf+h9BuT+2mXOaiEtonio=; h=cc:to:subject:date:from; d=lease-up.com; b=paynOM0i0lWutJxuPsnCp4/vHB2levUigFH3KdYexXIqsW8zXCbf yFWTdrpzs2EfpCc+eeJz4RgQ5Q2funNTZ9hKhhHWnsSWA/NrUFq5/enzW0vMm+qpG2qz5L 2K3fD/bzrDn57L2V/qVsmnc/FUGthZh/MkYd5z2EH5n7sdeUE= Received: by sail-ipv4.us-core.com (OpenSMTPD) with ESMTPSA id d6e734e6 (TLSv1.3:TLS_CHACHA20_POLY1305_SHA256:256:NO) for <51000 <at> debbugs.gnu.org>; Mon, 22 May 2023 01:59:59 +0000 (UTC) Received: by mail-lf1-f54.google.com with SMTP id 2adb3069b0e04-4f24cfb8539so6271245e87.3 for <51000 <at> debbugs.gnu.org>; Sun, 21 May 2023 18:59:58 -0700 (PDT) X-Gm-Message-State: AC+VfDxiMftEdB8nvW/ZBWXIY6RS7M9DPaJwrUULXqu3VWSFRQiNngzy xJiH+q0TleTPf/1RybPhIz3vZrMYZEFp3Stp3vE= X-Google-Smtp-Source: ACHHUZ43hiVm25B8RliDCoq8wFpSOUpYi8mczZeyq36QkbbOiujMWTPG5Z4IyXnXrJpfORnXz6RqOadKx3ETechOdRM= X-Received: by 2002:ac2:443a:0:b0:4f3:b86a:3a40 with SMTP id w26-20020ac2443a000000b004f3b86a3a40mr1174770lfl.61.1684720796940; Sun, 21 May 2023 18:59:56 -0700 (PDT) MIME-Version: 1.0 From: Felix Lechner <felix.lechner@HIDDEN> Date: Sun, 21 May 2023 18:59:20 -0700 X-Gmail-Original-Message-ID: <CAFHYt549HO9d1W_=pZoMEQyQZS1iE25AAk2JUcoYKpmQmqY2ww@HIDDEN> Message-ID: <CAFHYt549HO9d1W_=pZoMEQyQZS1iE25AAk2JUcoYKpmQmqY2ww@HIDDEN> Subject: Please drop web manuals for released versions To: 51000 <at> debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 51000 Cc: John Kehayias <john.kehayias@HIDDEN>, Tobias Geerinckx-Rice <me@HIDDEN>, Efraim Flashner <efraim@HIDDEN> X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Hi, > Here is an untested patch Guix suffers from an unhelpful anachronism that search engines consistently rank historical versions of the Reference Manual [1] above the latest edition. [2] It's probably because third-parties link to historical versions more often than they do to the current version. Please drop the historical versions. Historical versions are irrelevant for current users and should only be shipped on installation media. The current edition is only a 'guix pull' away=E2=80=94a command we encourage widely. As an example for the grave but unnecessary confusion, the manual generally perceived as official lists the incorrect email address guix-patches <at> debbugs.gnu.org as a way to contribute to Guix. [3] Let's not put stumbling blocks before the blind, please. I beg you, let's think of our fellow human beings. Thanks! Kind regards, Felix Lechner [1] https://guix.gnu.org/manual/en/guix.html [2] https://guix.gnu.org/en/manual/devel/en/guix.html [3] https://guix.gnu.org/en/manual/en/guix.html#Multiple-Patches-1
bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.Received: (at 51000) by debbugs.gnu.org; 4 Oct 2021 07:08:11 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Oct 04 03:08:10 2021 Received: from localhost ([127.0.0.1]:35498 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1mXI54-0005p0-OT for submit <at> debbugs.gnu.org; Mon, 04 Oct 2021 03:08:10 -0400 Received: from mail-wr1-f49.google.com ([209.85.221.49]:44662) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <zimon.toutoune@HIDDEN>) id 1mXI52-0005on-Sl for 51000 <at> debbugs.gnu.org; Mon, 04 Oct 2021 03:08:09 -0400 Received: by mail-wr1-f49.google.com with SMTP id s15so737869wrv.11 for <51000 <at> debbugs.gnu.org>; Mon, 04 Oct 2021 00:08:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:subject:in-reply-to:references:date:message-id:mime-version :content-transfer-encoding; bh=v3QEvyxfSK17FjKBfpViXBVxhvp63SB9RXJz+Ef+ASc=; b=PLwRFaivRkdMbegiMwEU2+iHQPiQuPTUl+aYdYFrVAc4GNRzV842cEKovNNMnoe+l6 nuzh2bV19aC61JUkbuuvGC6pAnOvCer8u5kiBo/4dSwS8ETrytQ71lwAD6f4QCd8bXmz PaUZQxNGpl92hQyiP18CkKv4mLaMm8awjhWjE78w4VbDIEPCFE6tV79cCQnmqHlVysP9 wieGWEmSqNNPhjkFnvIKijMH+VVbLK1mfHzz8jXSPcYV6MK/TYbBKnj5kFxBTFMOsr2P Wy252ZVapFPGLRMi2gufkrn4UJqzRhfIAy9H+VgJU32EdypTToXBOvFE470trjDYLN6b x7Rw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:subject:in-reply-to:references:date :message-id:mime-version:content-transfer-encoding; bh=v3QEvyxfSK17FjKBfpViXBVxhvp63SB9RXJz+Ef+ASc=; b=S7bdBWCf/3q94z8FjYtKoDTbXlSl0rLfxYXbMuK+CGlOh4qxXyszzac7D/toZ0evWz lxONtRFA1m0LwH0+GMaTNZRdP2qnDiEmLesReLViAbZK8ors7sM8Muse8jRkTZtpmoSw 4Fqut3Y/aUld7pq+cSitD/xWRA2/ivz5gdLIOUZqw0QzZf61cJ7oOyz4wyxdJmwc19u8 3Cw6Im4MMPAXFRJGxEAWtYH2+ulw+LljNKQnokI/AZkT8QzEYVuH+YmwzkeQEiRTnibt h93aeAUM1rgdfAv6yG4QDUxJdpYNSjezRHu4v/zDpodF28gBDx/HmAqmBTm1p+T+6DAH WnTg== X-Gm-Message-State: AOAM532iyKbzo16xw6q1RDRuVOhW2OjuakEeNoXxeF39HMyYa5R4d9T7 F/Y+umf281iaWLa/5YHQyIjvJZWry5jAyg== X-Google-Smtp-Source: ABdhPJz+t1Xiudka5xFtqDgjxYQFond5FiZo6GFw26vW2Gw0ol+3DDvCHWihswYVmDzLbnEjQZE1UA== X-Received: by 2002:adf:fb50:: with SMTP id c16mr12245751wrs.120.1633331283064; Mon, 04 Oct 2021 00:08:03 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id u2sm13230998wrr.35.2021.10.04.00.08.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 04 Oct 2021 00:08:02 -0700 (PDT) From: zimoun <zimon.toutoune@HIDDEN> To: Tobias Geerinckx-Rice <me@HIDDEN>, 51000 <at> debbugs.gnu.org Subject: Re: bug#51000: The Web manual situation is still needlessly confusing In-Reply-To: <87ilydycps.fsf@nckx> References: <87ilydycps.fsf@nckx> Date: Mon, 04 Oct 2021 08:58:11 +0200 Message-ID: <864k9xff98.fsf@HIDDEN> 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: 51000 X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Hi, On Mon, 04 Oct 2021 at 00:12, Tobias Geerinckx-Rice via Bug reports for GNU= Guix <bug-guix@HIDDEN> wrote: > - We should make <https://guix.gnu.org/manual/en/guix.html> the=20 > =E2=80=98devel=E2=80=99 version, and move the stable version to to a ve= rsioned=20 > 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=20 > clearly explaining their nature. Good idea. :-) Cheers, simon
bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.
Received: (at 51000) by debbugs.gnu.org; 4 Oct 2021 06:34:33 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Oct 04 02:34:33 2021
Received: from localhost ([127.0.0.1]:35428 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1mXHYW-0002kv-SJ
for submit <at> debbugs.gnu.org; Mon, 04 Oct 2021 02:34:33 -0400
Received: from flashner.co.il ([178.62.234.194]:56422)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <efraim@HIDDEN>) id 1mXHYT-0002kg-RD
for 51000 <at> debbugs.gnu.org; Mon, 04 Oct 2021 02:34:31 -0400
Received: from localhost (unknown [141.226.169.107])
by flashner.co.il (Postfix) with ESMTPSA id 2ADC440417;
Mon, 4 Oct 2021 06:34:23 +0000 (UTC)
Date: Mon, 4 Oct 2021 09:31:59 +0300
From: Efraim Flashner <efraim@HIDDEN>
To: Tobias Geerinckx-Rice <me@HIDDEN>
Subject: Re: bug#51000: The Web manual situation is still needlessly confusing
Message-ID: <YVqf32IHhqhf/RDr@3900XT>
Mail-Followup-To: Efraim Flashner <efraim@HIDDEN>,
Tobias Geerinckx-Rice <me@HIDDEN>, 51000 <at> debbugs.gnu.org
References: <87ilydycps.fsf@nckx>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha512;
protocol="application/pgp-signature"; boundary="0CFEPyMU1OT3qNmv"
Content-Disposition: inline
In-Reply-To: <87ilydycps.fsf@nckx>
X-PGP-Key-ID: 0x41AAE7DCCA3D8351
X-PGP-Key: https://flashner.co.il/~efraim/efraim_flashner.asc
X-PGP-Fingerprint: A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 51000
Cc: 51000 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
--0CFEPyMU1OT3qNmv
Content-Type: multipart/mixed; boundary="G6ltNMkZ2QX/BLU4"
Content-Disposition: inline
--G6ltNMkZ2QX/BLU4
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
On Mon, Oct 04, 2021 at 12:12:55AM +0200, Tobias Geerinckx-Rice via Bug rep=
orts for GNU Guix wrote:
> Good evening Guix!
>=20
> Nary a literal week goes by that someone doesn't post confusion about this
> or that not being in =E2=80=98the manual=E2=80=99, where the manual turns=
out to be
> <https://guix.gnu.org/manual/en/guix.html> instead of the one actually
> shipped with their Guix.
>=20
> The current solution is pointing them to
> <https://guix.gnu.org/manual/devel/en/guix.html> and resetting the timer.
>=20
> Instead:
>=20
> - We should make <https://guix.gnu.org/manual/en/guix.html> the =E2=80=
=98devel=E2=80=99
> version, and move the stable version to to a versioned URL like
> <https://guix.gnu.org/manual/1.3.0/en/guix.html>.
>=20
> - 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.
--=20
Efraim Flashner <efraim@HIDDEN> =D7=A8=D7=A0=D7=A9=D7=9C=D7=A4 =
=D7=9D=D7=99=D7=A8=D7=A4=D7=90
GPG key =3D A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351
Confidentiality cannot be guaranteed on emails sent or received unencrypted
--G6ltNMkZ2QX/BLU4
Content-Type: text/plain; charset=utf-8
Content-Disposition: attachment;
filename="0001-hydra-Move-guix-manual-URLs.patch"
Content-Transfer-Encoding: quoted-printable
=46rom 5ae07d5d8db78d3f190a8780ba2eeaa5ce2c1be1 Mon Sep 17 00:00:00 2001
Message-Id: <5ae07d5d8db78d3f190a8780ba2eeaa5ce2c1be1.1633329044.git.efraim=
@flashner.co.il>
=46rom: Efraim Flashner <efraim@HIDDEN>
Date: Mon, 4 Oct 2021 09:28:20 +0300
Subject: [PATCH] hydra: Move guix-manual URLs.
This is likely to remove some ambiguity for which manual to use.
* hydra/berlin.scm (operating-system)[services]: Adjust
static-website-service-type services to change the locations of the
generated guix manuals.
* hydra/nginx/berlin.scm (guix.gnu.org-other-locations): Adjust
nginx-location-configuration for the manual locations.
---
hydra/berlin.scm | 7 ++++---
hydra/nginx/berlin.scm | 10 +++++-----
2 files changed, 9 insertions(+), 8 deletions(-)
diff --git a/hydra/berlin.scm b/hydra/berlin.scm
index 146173b..44324cf 100644
--- a/hydra/berlin.scm
+++ b/hydra/berlin.scm
@@ -300,7 +300,8 @@ Happy hacking!\n"))
(static-web-site-configuration
(git-url "https://git.savannah.gnu.org/git/guix.git=
")
(git-ref '(branch . "version-1.3.0"))
- (directory "/srv/guix-manual")
+ (directory "/srv/guix-manual-1.3.0")
+ (cache-directory "guix-manual-1.3.0")
(build-file "doc/build.scm")
(environment-variables
'(("GUIX_MANUAL_VERSION" . "1.3.0")
@@ -310,7 +311,7 @@ Happy hacking!\n"))
(service static-web-site-service-type
(static-web-site-configuration
(git-url "https://git.savannah.gnu.org/git/guix.git=
")
- (directory "/srv/guix-manual-devel")
+ (directory "/srv/guix-manual")
=20
;; XXX: Use a different cache directory to work aro=
und
;; the fact that (guix git) would use a same-named
@@ -318,7 +319,7 @@ Happy hacking!\n"))
;; above. Since both mcron jobs run at the same ti=
me,
;; they would end up using one branch or the other,=
in
;; a non-deterministic way.
- (cache-directory "guix-master-manual")
+ (cache-directory "guix-manual")
=20
(build-file "doc/build.scm")
(environment-variables
diff --git a/hydra/nginx/berlin.scm b/hydra/nginx/berlin.scm
index 44ff28e..14a94fe 100644
--- a/hydra/nginx/berlin.scm
+++ b/hydra/nginx/berlin.scm
@@ -768,14 +768,14 @@ PUBLISH-URL."
"alias /srv/guix.gnu.org/static;")))
=20
;; These rules take precedence over the '.pdf' and '.html' rules below.
- (nginx-location-configuration
- (uri "~ /manual/devel/(.*)$")
- (body (list "expires 4h;"
- "alias /srv/guix-manual-devel/$1;")))
(nginx-location-configuration
(uri "~ /manual/(.*)$")
- (body (list "expires 1d;"
+ (body (list "expires 4h;"
"alias /srv/guix-manual/$1;")))
+ (nginx-location-configuration
+ (uri "~ /manual/1.3.0/(.*)$")
+ (body (list "expires 1d;"
+ "alias /srv/guix-manual-1.3.0/$1;")))
(nginx-location-configuration
(uri "~ /cookbook/(.*)$")
(body (list "expires 4h;"
base-commit: 3069d5e8c8b00162af1d6e7705c8d235f2e3b56a
--=20
2.33.0
--G6ltNMkZ2QX/BLU4--
--0CFEPyMU1OT3qNmv
Content-Type: application/pgp-signature; name="signature.asc"
-----BEGIN PGP SIGNATURE-----
iQIzBAABCgAdFiEEoov0DD5VE3JmLRT3Qarn3Mo9g1EFAmFan98ACgkQQarn3Mo9
g1FWHQ/7BSr3r7g4nYE0ihSWgPLZAWHZDN1jWUvMkQjzmMR0UMrm2++9oRtv/6sa
td19oK8hHxXoGVkVlshsGBmP6Oe0KLnvwOkNprMRh/lBspqt00F3t7g2cBjiitGX
sV42yiBCpzUyBi5jaBSJcH6uRpPC9x+c74jPqouvsnrcm0TIL0zStAF15Re/y5gk
M5vN5pryorSvfzW7WwOFV+xOoiRlZsqNI3AUuxrvCAf8ecTUqJYJbblMj9ZnRhz2
yqFEFSg63UPbpbRyoADxyF+yRrcc81S5CtURBRtgLtoKpB0OsAnstWrnTDsekmqC
4Ce2nBPyS5SfAr0YlLA9EL7gpibqs83BKH8g5Kif8in3TmmQqAx6pZjAbMjK0wCg
UU/T8MLsf0D9zL2ll0YZlCbGhaX6/gsHZL4SztyJytRSSKNUbj60O1FSevK2a3iI
+ZZ1aE7YRgIgHCOCAV+9rPkdJUn9jaQQzVQN3bgSy18/xWWZiG5KUZRYVIy3umaR
Rrkl8nFPa2paStQIck8UhNvSX+RO58kYEruytS3JULsAZesqOmqYicOgOSOJ3oDP
2prWGGPBrjb9LK5haU+H4G+svK4tMBHqoP4DNS3gjoC2C75iGvZxFQyDz8SNEbrv
XVUitay3kfC9AclPyLnXbmitt8Q5ilRaE4Jte75xU+2qUuw2Yxo=
=o7iz
-----END PGP SIGNATURE-----
--0CFEPyMU1OT3qNmv--
bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.Received: (at 51000) by debbugs.gnu.org; 4 Oct 2021 04:19:55 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Oct 04 00:19:55 2021 Received: from localhost ([127.0.0.1]:35288 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1mXFSF-0007ab-Hm for submit <at> debbugs.gnu.org; Mon, 04 Oct 2021 00:19:55 -0400 Received: from mail-4322.protonmail.ch ([185.70.43.22]:50743) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <john.kehayias@HIDDEN>) id 1mXFSC-0007aN-68 for 51000 <at> debbugs.gnu.org; Mon, 04 Oct 2021 00:19:53 -0400 Date: Mon, 04 Oct 2021 04:19:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail; t=1633321185; bh=dnvu3mRvhKucMdu9a21bu3Shg1wgwxOBptOYEWGZ9dk=; h=Date:To:From:Reply-To:Subject:From; b=UbmS2yE5KGs99X0F/5rWnok1gCks83EWtmWsa0GsYnKRLcFBusYMU/V51WulQ983s 3z8INF3WNOADeSgAqVBHYZ5Kmo/2WR2q6S+pgliq0CTA0pKiFULkGBGHoHeVNDWfIM GZSW1GZ1DANFYKwqWiTx4AQoDRRvR6vsu/2eIsQw= To: "51000 <at> debbugs.gnu.org" <51000 <at> debbugs.gnu.org> From: John Kehayias <john.kehayias@HIDDEN> Subject: Re: The Web manual situation is still needlessly confusing Message-ID: <susz0kTIZduiBm3i-bxbWioXd1-7m0GKVQJHBNMOHlb7o-yzcFfKyFS77l1TZEZuag_GtYjhtIJmZflLEbZNZbTMIYwNbX6Rgluz0O6KEuA=@protonmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-1.2 required=10.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM shortcircuit=no autolearn=disabled version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on mailout.protonmail.ch X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 51000 X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Reply-To: John Kehayias <john.kehayias@HIDDEN> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -1.0 (-) Hi everyone, Definitely agree with needing this to be clearer than it is currently. As a= new user I was a bit confused over the different manual versions on the we= bsite (which is still how I prefer to read the manual). As a side note, whe= n searching online with Guix questions, I think I only see the 'stable' ver= sion come up in results. We could perhaps be clearer in what is meant by the 'stable'/1.3.0 document= ation. Seems this is mostly needed in preparing for installation (with the = 1.3.0 image, not if building a current install image, of course) and during= installation. Afterward, users will probably run a guix pull very soon (as= in Getting Started, or as recommended by the guix command itself) and thus= no longer be on the 1.3.0 manual. I'm not sure how best to communicate thi= s on the website, but to me it is related to the next point: I think we need something describing what we mean by Guix versions and rele= ases, perhaps in the Intro and/or Getting Started sections (and on an About= type page?). I was confused by this starting out, as I'm used to rolling d= istros like Arch (or, a long time ago, distros like Debian). While Guix is = mostly 'rolling', we also have releases with certain package changes (like = core-updates) and Guix changes. Just a simple description would I think hel= p new users and give better context for the manual versions, however we lab= el or make them available. I'm happy to take a stab and making either of these points clearer, especia= lly as one newer to Guix with these questions and assumptions nearer to min= d. John
bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.Received: (at submit) by debbugs.gnu.org; 3 Oct 2021 22:18:19 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Sun Oct 03 18:18:18 2021 Received: from localhost ([127.0.0.1]:35088 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1mX9oI-0006o7-Oo for submit <at> debbugs.gnu.org; Sun, 03 Oct 2021 18:18:18 -0400 Received: from lists.gnu.org ([209.51.188.17]:42706) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <me@HIDDEN>) id 1mX9oF-0006ny-SS for submit <at> debbugs.gnu.org; Sun, 03 Oct 2021 18:18:17 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:59260) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <me@HIDDEN>) id 1mX9oF-0000Di-Fk for bug-guix@HIDDEN; Sun, 03 Oct 2021 18:18:15 -0400 Received: from tobias.gr ([2a02:c205:2020:6054::1]:60302) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <me@HIDDEN>) id 1mX9oD-0006IT-G0 for bug-guix@HIDDEN; Sun, 03 Oct 2021 18:18:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; s=2018; bh=lx1l5bMwGu6Xg bVqqfN/StyApKFpdDsJnb65EcLwWBU=; h=date:subject:to:from; d=tobias.gr; b=NVl43EIWRf8jqiyin02TdBFwY3r8up1SwqPyaprfOatUAUwGtjfFdKV0Qz19MO/EXCdT 5STZ6o+EajnFylUQcSLbtCcPMDXqu+mviQULqw09XjOT7O/0bjDfqHb7vM1SoH3qSbq6eH pltY1O+0VhkPfhCPeed7C/w2gjoAR2NouvvbJPfJG4uB7z4iyS7EJP47pyORVLTkE4ZK9I Ga9m571Bui9IkJ+6Ye072nTbJcz/dMwpcS/0jKY3Y+58Z8hAbCZaB2l6AxWP/fOsosHF38 kW61LpuJoTeMq/oRztVbIgnbi7HoRRS0ODtRSJEe4AjduIeVpifFazsFqDzSLGWw== Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id dba32211 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO) for <bug-guix@HIDDEN>; Sun, 3 Oct 2021 22:18:06 +0000 (UTC) From: Tobias Geerinckx-Rice <me@HIDDEN> To: Bug reports for GNU Guix <bug-guix@HIDDEN> Subject: The Web manual situation is still needlessly confusing Date: Mon, 04 Oct 2021 00:12:55 +0200 BIMI-Selector: v=BIMI1; s=default; Message-ID: <87ilydycps.fsf@nckx> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Received-SPF: pass client-ip=2a02:c205:2020:6054::1; envelope-from=me@HIDDEN; helo=tobias.gr X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.6 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -2.6 (--) --=-=-= Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable Good evening Guix! Nary a literal week goes by that someone doesn't post confusion=20 about this or that not being in =E2=80=98the manual=E2=80=99, where the man= ual=20 turns out to be <https://guix.gnu.org/manual/en/guix.html> instead=20 of the one actually shipped with their Guix. The current solution is pointing them to=20 <https://guix.gnu.org/manual/devel/en/guix.html> and resetting the=20 timer. Instead: =2D We should make <https://guix.gnu.org/manual/en/guix.html> the=20 =E2=80=98devel=E2=80=99 version, and move the stable version to to a vers= ioned=20 URL like <https://guix.gnu.org/manual/1.3.0/en/guix.html>. =2D Both manuals should have a gorgeous CSS box at the very top=20 clearly explaining their nature. Kind regards, T G-R --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iIMEARYKACsWIQT12iAyS4c9C3o4dnINsP+IT1VteQUCYVosIA0cbWVAdG9iaWFz LmdyAAoJEA2w/4hPVW15uOkA/jrtFZbSAv+twHdy3r7sIFZ3POJPJm+kQOahb2zk VOgCAP4pumzKl5gVxn3VvAnFxhx9L37AC8LByXyHLqtCmv3/CA== =yHWb -----END PGP SIGNATURE----- --=-=-=--
Tobias Geerinckx-Rice <me@HIDDEN>:bug-guix@HIDDEN.
Full text available.bug-guix@HIDDEN:bug#51000; Package guix.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.