X-Loop: help-debbugs@HIDDEN Subject: bug#62160: Guix reference manual link from guix.gnu.org? Resent-From: Simon Josefsson <simon@HIDDEN> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> Resent-CC: bug-guix@HIDDEN Resent-Date: Mon, 13 Mar 2023 12:13:02 +0000 Resent-Message-ID: <handler.62160.B.167870952423722 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: report 62160 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 62160 <at> debbugs.gnu.org X-Debbugs-Original-To: bug-guix@HIDDEN Received: via spool by submit <at> debbugs.gnu.org id=B.167870952423722 (code B ref -1); Mon, 13 Mar 2023 12:13:02 +0000 Received: (at submit) by debbugs.gnu.org; 13 Mar 2023 12:12:04 +0000 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> From: Simon Josefsson <simon@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-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--
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Simon Josefsson <simon@HIDDEN> Subject: bug#62160: Acknowledgement (Guix reference manual link from guix.gnu.org?) Message-ID: <handler.62160.B.167870952423722.ack <at> debbugs.gnu.org> References: <06c03ed58df9c9419ed11e45a8a95bb5666e97b2.camel@HIDDEN> X-Gnu-PR-Message: ack 62160 X-Gnu-PR-Package: guix Reply-To: 62160 <at> debbugs.gnu.org Date: Mon, 13 Mar 2023 12:13:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-guix@HIDDEN If you wish to submit further information on this problem, please send it to 62160 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 62160: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D62160 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
X-Loop: help-debbugs@HIDDEN Subject: bug#62160: Guix reference manual link from guix.gnu.org? Resent-From: Simon Tournier <zimon.toutoune@HIDDEN> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> Resent-CC: bug-guix@HIDDEN Resent-Date: Tue, 14 Mar 2023 11:30:02 +0000 Resent-Message-ID: <handler.62160.B62160.167879337127418 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: followup 62160 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Simon Josefsson <simon@HIDDEN>, 62160 <at> debbugs.gnu.org Received: via spool by 62160-submit <at> debbugs.gnu.org id=B62160.167879337127418 (code B ref 62160); Tue, 14 Mar 2023 11:30:02 +0000 Received: (at 62160) by debbugs.gnu.org; 14 Mar 2023 11:29:31 +0000 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> 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-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
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.