Received: (at 62160) by debbugs.gnu.org; 14 Mar 2023 11:29:31 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Mar 14 07:29:30 2023
Received: from localhost ([127.0.0.1]:36487 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1pc2qQ-00078A-Hg
for submit <at> debbugs.gnu.org; Tue, 14 Mar 2023 07:29:30 -0400
Received: from mail-wr1-f45.google.com ([209.85.221.45]:42852)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <zimon.toutoune@HIDDEN>) id 1pc2qO-00077x-Nm
for 62160 <at> debbugs.gnu.org; Tue, 14 Mar 2023 07:29:29 -0400
Received: by mail-wr1-f45.google.com with SMTP id j2so13988969wrh.9
for <62160 <at> debbugs.gnu.org>; Tue, 14 Mar 2023 04:29:28 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=20210112; t=1678793363; x=1681385363;
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=Buap+rZOFuKlj41hsAVzvwRTaMJvawRhmWvOuOFVmKU=;
b=ZFSjgX62a4NR2tbzJY1KLuGLVXSo02xrL9ITkzOJluSIfMLEVWx81oM0d3ipQ0z5nl
jCPX0XdV2THRUuCYEHFuVnMS6vcOtrS6amIBM+1IXm17LhdJai00WnCjba3OLzEId+d1
D4icoEMoujtRSQDx44kdx1iA61Fb0DRNDPPWUY44nP7L8H8EvVzY4Q1rS4Nioj4varCO
BtBuQKEg9PG/iz6sNMzsJFg2mQfgGok/FmYWbLRYB11nPivWIAdfrzy0MOKBVklVSnlo
n6nu/XP7N6H3RWkBErWHS4mW5l3Nipck9K+L03iBjii6O31QXLxG107ndJsyq2Ig01Bh
8+6A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20210112; t=1678793363; x=1681385363;
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=Buap+rZOFuKlj41hsAVzvwRTaMJvawRhmWvOuOFVmKU=;
b=dzJnQAt9fde1l3sZKHcRjqlNyY/2S6AG7UC246i9PfrbNffZ0pzVB2Np+XbB9Ma9VX
R/tz0aLKCgF97mwIfhL5kkSsYHPEDI6MEz82ZnqmgTE2wk5pV+vCGLat+NBr3ZS/gp/N
JyUvMYFLLkjk55U60QxK/Ds8siwz8GUFNnURTWrFE2DY/z/yTAt8sY4l27Ufri3L1PQL
LRTcU5xl2QDwPhVdejBl1nNdV8QcUNGbTDTlNt6j/N2fo6ZjsptZMowtZIyZZddwS7JH
FgpXqUzkk9UThDROtd/TvgARGsEx2G78tan8Tu7mjAAW695h6Gl2qHnX7pbNIX6QfpS6
4I1Q==
X-Gm-Message-State: AO0yUKWG6P1WnOqwfZEmuM7fe50lA+XQqrbEVYRd+Pwshy3TLzw16ih6
sAGytPeAArTpJX5U9EoMBIqbmQOVxp4=
X-Google-Smtp-Source: AK7set+xEROBVaMfaEj7p0cJdJRkeBb9+QXb4Ixc/8BlkI3B4a/en9bvpz3lqUQ26RB0wEwseXCMYw==
X-Received: by 2002:a5d:434d:0:b0:2c7:1c4e:1d16 with SMTP id
u13-20020a5d434d000000b002c71c4e1d16mr8832058wrr.0.1678793362739;
Tue, 14 Mar 2023 04:29:22 -0700 (PDT)
Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e])
by smtp.gmail.com with ESMTPSA id
w7-20020adfd4c7000000b002c557f82e27sm1866413wrk.99.2023.03.14.04.29.22
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Tue, 14 Mar 2023 04:29:22 -0700 (PDT)
From: Simon Tournier <zimon.toutoune@HIDDEN>
To: Simon Josefsson <simon@HIDDEN>, 62160 <at> debbugs.gnu.org
Subject: Re: bug#62160: Guix reference manual link from guix.gnu.org?
In-Reply-To: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
References: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN>
Date: Tue, 14 Mar 2023 12:29:11 +0100
Message-ID: <86h6un1shk.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: 62160
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 Simon,
On Mon, 13 Mar 2023 at 13:11, Simon Josefsson via Bug reports for GNU Guix =
<bug-guix@HIDDEN> wrote:
> I often go to guix.gnu.org to read the (excellent!) Guix manual. This
> leads to this click pattern: guix.gnu.org -> Help -> GNU Guix Manual
> 1.4.0 which leads me to a page (written in english) to chose language
> of the manual -- https://guix.gnu.org/en/manual/ -- and when I chose
> English I get a page to chose format of manual --
> https://guix.gnu.org/en/manual/en/ -- and that choice takes a split
> second cognitive load.
Well, personally I never read en/manual/ but always en/manual/devel/. :-)
And I have a short-cut (or bookmark) for opening
<https://guix.gnu.org/en/manual/devel/en/guix.html>.
> How about these changes to improve user experience?
>
> 1) The link guix.gnu.org -> Help -> GNU Guix Manual 1.4.0 goes directly
> to the split-node https://guix.gnu.org/en/manual/en/html_node/
Well, I do not have an opinion since I barely read released manual but
only the more accurate devel manual.
However, my preference is about =E2=80=99entirely on one page=E2=80=99 an n=
ot =E2=80=99with a
separate page per node=E2=80=99 because =E2=80=99entirely on one page=E2=80=
=99 eases Control-f
for searching. :-)
> 1b) The link could respect the language-choice for the web-site,
> i.e., so if I'm browsing https://guix.gnu.org/de/ it should directly
> link me to https://guix.gnu.org/de/manual/de/html_node/ instead.
With this change, where can I choose the language for the manual?
The workflow would be,
From https://guix.gnu.org/
Click top right to language and select one, say French
Then click Aide -> Manuel and it would open the manual in French.
so I would have to come back the front page to switch from one language
to the other. Right?
Well, in addition, I would like to have a page proposition the manual
for all the languages, as we have now. For example, these two webpages:
https://guix.gnu.org/en/manual/devel/
https://guix.gnu.org/fr/manual/devel/
serve the same choice and I would like to keep it somewhere.
> 2) Add links to the PDF variant and full-HTML variants in the top-right
> menu where different languages are shown.
Do you mean add an item to the list,
--8<---------------cut here---------------start------------->8---
,(menu-dropdown
#:label (C_ "website menu" "Help")
[...]
(menu-item #:label "All"
[...]
(menu-item #:label (C_ "website menu"
(string-append "GNU Guix Manual "
[...]
(menu-item #:label "GNU Guix Manual (latest)"
[...]
(menu-item #:label "Guix Reference Card"
[...]
(menu-item #:label "Videos"
[...]
(menu-item #:label "Cookbook"
[...]
(menu-item #:label "GNU Manuals"
[...]
(menu-item #:label "Wiki"
[...]
(menu-item #:label "IRC Chat"
[...]
(menu-item #:label "Mailing Lists"
--8<---------------cut here---------------end--------------->8---
<https://git.savannah.gnu.org/cgit/guix/guix-artwork.git/tree/website/apps/=
base/templates/components.scm#n417>
?
Cheers,
simon
bug-guix@HIDDEN:bug#62160; Package guix.
Full text available.Received: (at submit) by debbugs.gnu.org; 13 Mar 2023 12:12:04 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Mon Mar 13 08:12:04 2023 Received: from localhost ([127.0.0.1]:33815 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1pbh23-0006AX-LS for submit <at> debbugs.gnu.org; Mon, 13 Mar 2023 08:12:03 -0400 Received: from lists.gnu.org ([209.51.188.17]:45522) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <simon@HIDDEN>) id 1pbh22-0006AK-CZ for submit <at> debbugs.gnu.org; Mon, 13 Mar 2023 08:12:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <simon@HIDDEN>) id 1pbh1x-0006Zh-Ug for bug-guix@HIDDEN; Mon, 13 Mar 2023 08:11:58 -0400 Received: from uggla.sjd.se ([2001:9b1:8633::107]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <simon@HIDDEN>) id 1pbh1w-00018E-0i for bug-guix@HIDDEN; Mon, 13 Mar 2023 08:11:57 -0400 DKIM-Signature: v=1; a=ed25519-sha256; q=dns/txt; c=relaxed/relaxed; d=josefsson.org; s=ed2110; h=MIME-Version:Content-Type:Date:To:From:Subject: Message-ID:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description; bh=u07WnZgXAOTkieQGkaGJpj4eVa0vKycPEzQEEa6kZeU=; t=1678709506; x=1679919106; b=1UfiLNOkrUh1I1HWDCPWMvvWXXRdJwuCISns809fle7QpEZ hFOmJvTsleeKDxmVjnvPTd4Vy/amNZtMuP6zmAQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=josefsson.org; s=rsa2110; h=MIME-Version:Content-Type:Date:To:From:Subject: Message-ID:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description; bh=u07WnZgXAOTkieQGkaGJpj4eVa0vKycPEzQEEa6kZeU=; t=1678709506; x=1679919106; b=ruLOm5s6Nss4IHoWJfCrqIh7RsObNCZTmvjMTeITgHjWXe/ s9/GEc+n3b+HzfhkV8Px4NyUpgPJNuvCXMsb0tvMJQm/UGVOXxJ2rqpt52OqSDapLKDzfP8c2t3QA 3xMk9xnSkG/q6Cy0/0mlDckVkHKA6aAjFxyemFDMwPgLTzzDN6M4GUs8GVoHAGmNzlzTUYM+UFckG L8wM7R0PaaeJXxaRwh8en3K2XQflPeU75TSR0vNJfXvyGsYFd/CRjKOeaGh34iN1CeowRfv1BTIHb devp2+YADF3MNJ02+uSZbZLXH5mxkDAv8vAObR9DRaikgoGCdXPLVj0tkebHDs4NOoxl5WmW2/fCg 9hdRlnKL5vI0YWGtYIhDr8XJw3BhoLf5+vOtkAI/CKtuT1S1/xlfIkvtZPRKCu6Gk/0+PCmuCZeeV 428huxC7UplAFvt0rA/2LmAj; Received: from [2001:9b1:41ac:ff00:ae3a:683b:55d1:737f] (port=42320 helo=h-2001-9b1-41ac-ff00-ae3a-683b-55d1-737f.na.bahnhof.se) by uggla.sjd.se with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from <simon@HIDDEN>) id 1pbh1j-00CDH1-7h for bug-guix@HIDDEN; Mon, 13 Mar 2023 13:11:43 +0100 Message-ID: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN> Subject: Guix reference manual link from guix.gnu.org? From: Simon Josefsson <simon@HIDDEN> To: bug-guix@HIDDEN Date: Mon, 13 Mar 2023 13:11:41 +0100 Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="=-sLNPLbi6EP4mmcKhxLx5" User-Agent: Evolution 3.44.4-0ubuntu1 MIME-Version: 1.0 Received-SPF: pass client-ip=2001:9b1:8633::107; envelope-from=simon@HIDDEN; helo=uggla.sjd.se X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.4 (-) 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.4 (--) --=-sLNPLbi6EP4mmcKhxLx5 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi I often go to guix.gnu.org to read the (excellent!) Guix manual. This leads to this click pattern: guix.gnu.org -> Help -> GNU Guix Manual 1.4.0 which leads me to a page (written in english) to chose language of the manual -- https://guix.gnu.org/en/manual/ -- and when I chose English I get a page to chose format of manual -- https://guix.gnu.org/en/manual/en/ -- and that choice takes a split second cognitive load. How about these changes to improve user experience? 1) The link guix.gnu.org -> Help -> GNU Guix Manual 1.4.0 goes directly to the split-node https://guix.gnu.org/en/manual/en/html_node/ 1b) The link could respect the language-choice for the web-site, i.e., so if I'm browsing https://guix.gnu.org/de/ it should directly link me to https://guix.gnu.org/de/manual/de/html_node/ instead. 2) Add links to the PDF variant and full-HTML variants in the top-right menu where different languages are shown. What do you think? Then you quickly get into the manual, and there is still a simple way to chose other languages, and to get PDF/full-HTML variants. I don't see any significant disadvantage with this change. /Simon --=-sLNPLbi6EP4mmcKhxLx5 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- iHUEABYIAB0WIQSjzJyHC50xCrrUzy9RcisI/kdFogUCZA8S/QAKCRBRcisI/kdF og5fAP0YLSfD35S5/PuD5Kd5fZqKPa2gzDt463l92NiH6fuEzAD/Uma2iDlXKIRq xAiKuRMDqLcc1RBkVR/pkY5k+nXFtgU= =Rau0 -----END PGP SIGNATURE----- --=-sLNPLbi6EP4mmcKhxLx5--
Simon Josefsson <simon@HIDDEN>:bug-guix@HIDDEN.
Full text available.bug-guix@HIDDEN:bug#62160; Package guix.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.